5 Configuring System

This chapter introduces how to configure system.

5.1 Finding Device IP

In some application scenarios, it is necessary to remotely log in or manage devices, so it is necessary to obtain the device IP.

5.1.1 View IP address At The Network Icon Of Desktop

After the device starting normally and the display is connected, you can view the current device IP address at the Network icon.

TIP

Only supported by Desktop version system.

Preparation:

The device has been connected to the network through the router.

Steps:

Hover over the network icon in the system tray, and a tooltip will appear. This tooltip displays the name of the network you’re currently connected to and your IP address.

5.1.2 Hostname Command To Query

After the device starting normally and the display is connected, you can query the current device IP address by using hostname command.

Preparation:

The device has been connected to the network through the router.

Steps:

Run the following command in the command pane to obtain IP address.

hostname -I

5.1.3 Query IP by Using ifconfig Command

After the device is started normally and the display is connected, you can use the ifconfig command to view the current device IP.

Preparation:

The device has been connected to the network through the router.

Steps:

Run the following command in the command pane to view the detailed information of each port of the device, where the inet value in the eth1 interface is the device IP, as shown in the following figure.

ifconfig

WARNING

If the two Ethernet ports of device are all connected to Ethernet, the two IP addresses found are all device IP addresses.

5.1.4 Query IP by Using Network Manager CLI

After the device is started normally and the display is connected, you can use the built-in Network Manager CLI (nmcli) to view details about your network.

Preparation:

The device has been connected to the network through the router.

Steps:

Run the following command in the command pane to view the detailed network information.

nmcli device show

5.1.5 Login Router To Query IP

When the device starts normally, you can log in to the router to check the current device IP.

Preparation:

• The device has been connected to the network through the router.
• The IP and network password of the router in the network have been obtained, and the IP address is 192.168.X.X.

Steps:

1. Open a browser, Enter the router IP of the network where the device is located in the address bar: 192.168.x.x, and press Enter to enter the router login interface.
2. According to the interface prompts, enter the network password and enter the router management interface.
3. Find the IP address of device in the terminal device of the management interface.

5.1.6 Scan For Using NMAP Tool

When the device starts normally, you can use nmap tool to scan the IP under the current network to obtain the IP information of the device. Nmap supports Linux, macOS, Windows and other platforms.

Preparation:

• The device has been connected to the network through the router.
• The IP segment and mask of the router in the network have been obtained, for example, 192.168.X.X/24, where 24 is the subnet mask.

Steps:

For example, using nmap to scan the network segments from 192.168.3.0 to 255, you can use the following steps:

1. Open the nmap tool and scan the hosts in the 192.168.X.X/24 network segment.

WARNING

The nmap tool operates differently in different operating systems, so please follow the actual interface or command prompts.

2. According to the scanned results, get the device IP.

5.2 Remote Login

There are many remote login methods, and users can choose according to their actual needs. This chapter only introduces SSH and VNC.

5.2.1 Connect To The Device Via SSH

After the device starts normally, you can choose to connect to the device remotely through SSH to configure or debug it. The tools for remote login are selected by users themselves, and the following is an example of logging in through MobaXterm.

Preparation:

• The MobaXterm tool has been installed on the PC.
• The device has been connected to the network through the router.
• IP address of the device has been get.

Steps:

1. Open MobaXterm, click, and open the window for creating connection, as shown in the figure below.

2. Click in the upper left corner to open the SSH connection interface.

3. After entering the IP address of the obtained device, click "OK".

4. Click "Accept" in the pop-up prompt box to enter the system login interface.
5. Enter the username and password according to the prompt, and enter the system after logging in.

TIP

Default username is pi, Default password is raspberry.

5.2.2 Connect To The Device Desktop Through VNC

After the device starts normally, you can choose to connect to the device remotely through VNC to configure or debug it.

Preparation:

• The RealVNC Viewer tool has been installed on PC.
• The device has been connected to the network through the router.
• IP address of the device has been get.
• The VNC function in the system has been turned on, as shown in the following figure.

Steps:

1. Open RealVNC Viewer and select "New connection…" in the File in the menu bar to open the window for creating a connection, as shown in the following figure.

2. After entering the IP address of device, click "OK".

3. Enter the username and password in the Authentication prompt box that pops up.

TIP

Default username is pi, Default password is raspberry.

4. Select "OK" to log in and connect to the remote desktop.

5.3 Configuring Storage Devices

You can connect your external SSD or USB disk to the corresponding port on the device and mount the file system to access the data stored on it. When the device is turned off, it is necessary to unmount the storage device so that it can be safely pulled out.

The connectable storage devices of device include USB storage devices and SSD. This chapter introduces how to configure the mounting and unmounting of storage devices.

5.3.1 Mounting a Storage Device

If the Lite version of the operating system is used (the Desktop version of the system supports automatic mounting), after the storage device is connected to the corresponding port on the device, it is necessary to mount the storage device in a specific folder location through configuration, usually in the /mnt folder, such as /mnt/mydisk.

TIP

The /mnt folder must be empty.

Preparation:

The storage device is ready to be mounted.

Steps:

1. Connect the storage device to be mounted to the corresponding port on the device (USB storage device is inserted into USB port).
2. Run the following command to view all disk partitions on the device.

sudo lsblk -o UUID,NAME,FSTYPE,SIZE,MOUNTPOINT,LABEL,MODEL

​After running the command, the information displayed is as follows:

​

• UUID, NAME, FSTYPE, SIZE, MOUNTPOINT, LABEL and MODEL are disk parameters that need to be listed.

• The types of MOUNTPOINT are / and /boot.

• The storage device whose LABEL is ADMESY is the inserted USB storage device, and the corresponding disk name is sda1.

• FSTYPE indicates the file system type contained.

• If the file system type of the inserted storage device is exFAT, please run the following commands to install the exFAT driver.

​sudo apt update
​sudo apt install exfat-fuse

• If the file system type of the inserted storage device is NTFS (only read permission is supported), you can install ntfs-3g driver to realize write permission. Run the following commands to install ntfs-3g drivers.

​sudo apt update
​sudo apt install ntfs-3g

3. Run the following command to get the location of the disk partition.

sudo blkid

​After running the command, the following information is displayed, which the disk partition of the connected storage device is displayed as /dev/sda1.

​

4. Create a target folder as the mount point of the storage device. Assuming that the mount name is mydisk and the directory to be mounted is /mnt, the command to be executed is as follows:

sudo mkdir /mnt/mydisk

5. Mount the storage device at the created mount point, and execute the following command:

sudo mount /dev/sda1 /mnt/mydisk

6. Verify the success of mounting the storage device by executing the following command.

ls /mnt/mydisk

• After executing the command, if the displayed information lists all files in the storage device, it means that the mount is successful.
• After executing the command, if the displayed information does not list the contents of related files, it means that the mount is failed.

5.3.2 Unmount The Storage Device

When the device is turned off, it is necessary to manually unmount the storage device so that it can be pulled out safely.

WARNING

Both Lite and Desktop versions of the system need to manually unmount the storage device.

Preparation:

The storage device has been successfully mounted.

Steps:

If /mnt is the mounted directory and mydisk is the name of the mount point, you can execute the following command to complete the unmounting.

sudo umount /mnt/mydisk

• After executing the command, if no error message is displayed, it means that the unmounting has been completed and the storage device can be completely pulled out.
• After executing the command, if an error message is displayed, it means that the unmounting is failed.

5.3.3 Set The Storage Device To Mount Automatically

If you are using the Lite version of operating system, you can automatically mount it by modifying the fstab settings.

Preparation:

The storage device to be mounted has been connected to the corresponding port on the device.

Steps:

1. Execute the following command to view all disk partitions on the device and get the file system type of the storage device to be mounted, as “vfat” shown in the figure below.

sudo lsblk -o UUID,NAME,FSTYPE,SIZE,MOUNTPOINT,LABEL,MODEL

​

2. Execute the following command to obtain the UUID of the storage device to be mounted, such as "7C9E-4F13" in the figure below.

sudo blkid

​

3. Execute the following command to open the fstab file.

sudo nano /etc/fstab

4. Add the following to the fstab file.

UUID=7C9E-4F13 /mnt/mydisk vfat defaults,auto,users,rw,nofail 0 0

• The value of UUID is the value found in Step 2 above.
• /mnt is the directory to be mounted, and mydisk is the name of the mount point.
• Vfat is the file system type queried in step 1.
• If the type of file system is FAT or NTFS, the added content is "UUID = 7C9E-4F13 /mnt/mydisk vfat defaults,auto,users,rw,no fail umask = 000 0 0",which will allow all users to "read/write" access to each file on the storage device.

WARNING

More information about the fstab command can be viewed by executing the man fstab command.

5. Use Ctrl+X to save the file and exit edit mode.

5.4 Configuring Ethernet IP

The IP address is automatically obtained by default. If you need to reconfigure the IP, you can configure it through NetworkManager and dhcpcd.

5.4.1 Configure IP By Using The NetworkManager Tool

The operating systems of Desktop and Lite have enabled NetworkManager by default, which can be directly configured by using NetworkManager.

5.4.1.1 Raspberry Pi OS (Desktop)

In the Desktop version of the operating system, it is recommended to use the graphical NetworkManager tool to configure IP.

WARNING

The Desktop version of the operating system has the NetworkManager graphical tool installed by default.

Preparation:

Wi-Fi is enabled.

Steps:

1. Left-click the icon in the upper right corner of the desktop and select “Advanced Options” → “Edit Connections” in the pop-up menu.

2. In the pop-up "Network Connections" pane, select the connection name to be modified, and then click the Settings button below.

3. In the pop-up "Editing Wired connection" pane, select the "IPv4 Settings" page, and then set the IP address as required.

• If you want to set the IP as a static IP, set the "Method" as "Manual", add an entry in Addresses and enter the corresponding IP address information.

• If you want to set the IP to automatic mode, you only need to set the "Method" as "Automatic(DHCP) ".

4. Click "save" to return to "Network Connections" pane and close the page.
5. Execute the sudo reboot command to restart the device.

5.4.1.2 Raspberry Pi OS (Lite)

In the Lite version of operating system, it is recommended to use the command to configure IP.

Preparation:

NetworkManager is enabled.

Steps:

• Set a static IP address

1. Get the assigned IP address, subnet mask and gateway address, for example, the IP address is 192.168.1.101/24 and the gateway IP is 192.168.1.1.
2. Obtain the connection name to be modified, for example e167c45f-efed-3f8d-89a5-f2430f92fae8. In the command pane, run the following command to query the connection name.

nmcli c

3. Execute the following command to set the IP address to the obtained IP address.

sudo nmcli connection modify e167c45f-efed-3f8d-89a5-f2430f92fae8 ipv4.addresses 192.168.1.101/24 ipv4.method manual

4. Execute the following command to set the gateway IP to the obtained gateway IP.

sudo nmcli connection modify e167c45f-efed-3f8d-89a5-f2430f92fae8 ipv4.gateway 192.168.1.1

• Set the IP to automatic mode

1. Obtain the connection name to be modified, for example e167c45f-efed-3f8d-89a5-f2430f92fae8. In the command pane, run the following command to query the connection name.

nmcli c

2. Execute the following command to set the way of obtaining IP address to automatic mode.

sudo nmcli connection modify e167c45f-efed-3f8d-89a5-f2430f92fae8 ipv4.method auto

5.4.2 Configure IP By Using The dhcpcd Tool

Since NetworkManager is enabled on the Desktop and Lite of operating systems by default. If you need to switch to using the dhcpcd tool for configuration, you need to stop and disable the NetworkManager service and enable the dhcpcd service before configuration.

Steps:

1. Execute the following command to stop the NetworkManager service.

sudo systemctl stop NetworkManager

2. Execute the following command to disable the NetworkManager service.

sudo systemctl disable NetworkManager

3. Execute the following command to enable the dhcpcd service.

sudo systemctl enable dhcpcd`

4. Execute the following command to restart the device.

sudo reboot

5. Execute the following command to open the /etc/dhcpcd.conf file.

sudo nano /etc/dhcpcd.conf

6. Add the following content at the end of the /etc/dhcpcd.conf file.

   interface eth0
   static ip_address=192.168.168.210/24
   static routers=192.168.168.1
   static domain_name_servers=192.168.168.1 8.8.8.8 fd51:42f8:caae:d92e::1

• eth0 is the Ethernet port of the IP to be configured;
• 192.168.0.10/24 indicates the IP address and subnet mask to be configured;
• 192.168.0.1 indicates the gateway IP to be configured;
• 8.8.8.8 represents the DNS server address, which should be configured according to the actual needs.
• fd51:42f8:caae:d92e::1 indicates the IPV6 address, which should be configured according to the actual needs.

7. Use Ctrl+S to save the file, then enter Ctrl+X to exit edit mode.
8. Execute the following command to reboot the device.

sudo reboot

5.5 Configuring Wi-Fi

User can choose the device with Wi-Fi version, which needs to be configured before using Wi-Fi function.

The Wi-Fi feature is enabled by default, with the WLAN country code preset to "CN China". Before connecting to a Wi-Fi network, you need to ​modify the WLAN country code​ to match your location's regulatory requirements.

5.5.1 Set WLAN Country Code

The default WLAN country code is set to "CN China"​. Please ​configure an appropriate WLAN country code​ before connecting to Wi-Fi.

5.5.1.1 Raspberry Pi OS (Desktop)

In the Desktop version of the operating system, you can use the desktop menu to set WLAN country code.

Steps:

1. Left-click the icon in the top-left corner of the desktop and select "Preferences"→"Raspberry Pi Configuration" in the menu.

2. In the ​Raspberry Pi Configuration​ interface, select ​​"Localisation"​.

3. Click "Set WLAN Country...", Set the value of Country in the pop-up "Wireless LAN Country" pane, and select it to match your location's regulatory requirements.

4. Select "OK" to complete the setting.

5.5.1.2 Raspberry Pi OS (Lite)

In the Lite version of the operating system, you can use the command line to set WLAN country code.

Setps:

1. Open the command terminal pane and execute the following command to open the Raspberry Pi Software Configuration Tool (raspi-config)interface.

sudo raspi-config

2. Choose "5 Localisation Options" and press "Enter".

3. Select "L4 WLAN Country" and press "Enter".

4. Select a country code to match your location's regulatory requirements and press "Enter".

5. Press "Enter" in Wireless LAN country set to CN interface.

6. In the main interface of the pane, select "Finish" and press Enter to complete the setting and return to the command line.

5.5.2 Use The NetworkManager Tool To Configure Wi-Fi Connections

The operating systems of Desktop and Lite have enabled NetworkManager by default, which can be directly configured by using NetworkManager.

5.5.2.1 Raspberry Pi OS (Desktop)

In the Desktop version of the operating system, you can connect to Wi-Fi through the desktop icon.

Preparation:

Wi-Fi function is enabled.

Steps:

1. Left-click the icon in the upper right corner of the desktop, select the Wi-Fi name and click it in the pop-up Wi-Fi list.

2. Input the Wi-Fi Password in the pop-up Wi-Fi Network Authentication Required pane.

3. Click "Connect" to connect to the network. After the connection is completed, you can click icon to view Wi-Fi information.

5.5.2.2 Raspberry Pi OS (Lite)

In the Lite version of the operating system, it is supported to configure Wi-Fi through the command line.

Preparation:

• Wi-Fi function is enabled.
• The Wi-Fi name and password that can be connected are prepared, for example, the Wi-Fi name is SSID and the password is password.

Steps:

1. Open the terminal and execute the following command to scan the list of connectable Wi-Fi name.

sudo nmcli device wifi

2. Execute the following command to connect the Wi-Fi.

sudo nmcli device wifi connect SSID password password

Where SSID is the name of the Wi-Fi and the second password is the password of the Wi-Fi.

3. Execute the following command to set up automatic Wi-Fi connection.

sudo nmcli connection modify SSID connection.autoconnect yes

• Where SSID is the name of the Wi-Fi.

5.5.3 Configure Wi-Fi Connection By Using raspi-config Tool

In both Desktop and Lite versions of the operating system, you can connect to Wi-Fi through the raspi-config tool.

Preparation:

• Wi-Fi function is enabled.
• The Wi-Fi name and password that can be connected are prepared, for example, the Wi-Fi name is EDATEC-WH and the password is password.

Steps:

1. Open the terminal and execute the following command to open the Raspberry Pi Software Configuration Tool (raspi-config) interface.

sudo raspi-config

2. Select "1 System Options" and press "Enter", and then select "S1 Wireless LAN" in the interface.

3. Press "Enter", then input the Wi-Fi name in the Please enter SSID interface.

4. Press "Enter", then input the Wi-Fi password in the Please enter passphrase. Leave it empty if none interface.

5. Press "Enter" to connect Wi-Fi. When the Wi-Fi is connected successfully, select "Finish" and press "Enter" to complete the setting and return to the command line window.

5.6 Configuring Bluetooth

User can choose the device with Bluetooth version, and the Bluetooth function is enabled by default, You need to finish related configurations such as adding devices, scanning devices and device pairing before using Bluetooth.

5.6.1 Raspberry Pi OS (Desktop)

In the Desktop version of the operating system, you can use the desktop icon to configure Bluetooth.

Steps:

1. Left-click the icon in the upper right corner of the desktop and select “Add Device” in the pop-up menu.

2. In the pop-up "Add New Device" pane, view the scanned Bluetooth devices. Then you can select a Bluetooth device, and click “Pair” to start pairing.

3. Select “OK” in the pop-up prompt box to confirm the pairing request.

TIP

You need confirm the pairing request on connected Bluetooth device, otherwise the pairing will fail.

4. After successful Bluetooth pairing, click “OK” in the pop-up prompt to close the page.
5. Left-click the icon in the upper right corner of the desktop to view the connected Bluetooth device.

5.6.2 Raspberry Pi OS (Lite)

In the Lite version of the operating system, you can use the command line to configure Bluetooth.

5.6.2.1 Basic Configuration Command

Command	Function Description
bluetoothctl scan on	Enable Bluetooth scanning
bluetoothctl scan off	Disable Bluetooth scanning
bluetoothctl discoverable on	Enable Bluetooth discovery (which can be discovered by the other party)
bluetoothctl discoverable off	Disable Bluetooth discovery
bluetoothctl trust *device_MAC*	Trust device
bluetoothctl connect *device_MAC*	Connect device
bluetoothctl disconnect *device_MAC*	Disconnect device

5.6.2.2 Configuration Example

This chapter introduces how to configure Bluetooth through a configuration example.

Preparation:

The Bluetooth to be paired has been enabled and its name has been determined.

Steps:

1. Enter the Bluetooth view.

sudo bluetoothctl

2. Enable bluetooth.

power on

3. Scan Bluetooth device.

scan on

​Returned display information:
​Discovery started
​[CHG] Controller B8:27:EB:85:04:8B Discovering: yes
​[NEW] Device 4A:39:CF:30:B3:11 4A-39-CF-30-B3-11

4. Find the name of the turned-on Bluetooth device.

devices

​Returned display information:
​Device 6A:7F:60:69:8B:79 6A-7F-60-69-8B-79
​Device 67:64:5A:A3:2C:A2 67-64-5A-A3-2C-A2
​Device 56:6A:59:B0:1C:D1 Lefun
​Device 34:12:F9:91:FF:68 test

5. Pairing target devices.

pair 34:12:F9:91:FF:68

​34:12:F9:91:FF:68 is target device’s device_MAC.

​Returned display information:
​Attempting to pair with 34:12:F9:91:FF:68
​[CHG] Device 34:12:F9:91:FF:68 ServicesResolved: yes
​[CHG] Device 34:12:F9:91:FF:68 Paired: yes
​Pairing successful
Pairing successful

TIP

The Bluetooth device to be connected also needs to confirm the pairing request, otherwise the pairing will fail.

6. Add as trusted device.

trust 34:12:F9:91:FF:68

​34:12:F9:91:FF:68 is target device’s device_MAC.

​Returned display information:
​[CHG] Device 34:12:F9:91:FF:68 Trusted: yes
​Changing 34:12:F9:91:FF:68 trust succeeded

5.7 Adjusting brightness and Volume

The ED-HMI3010-185C supports brightness and volume adjustment via physical buttons and software.

5.7.1 Adjust brightness and volume via buttons

After the ED-HMI3010-185C is powered on and displays normally, you can adjust the backlight brightness and output volume using the 5 side buttons.

Button	Description
	Press the button to increase the backlight brightness of the LCD screen.
	Press the button to decrease the backlight brightness of the LCD screen.
	Press the button to increase the output volume.
	Press the button to decrease the output volume.
	Press the button to mute the output audio.

5.7.2 Adjust Brightness and Volume via Software

After the ED-HMI3010-185C is powered on and displays normally, the backlight brightness and output volume can be adjusted via software. The corresponding operation methods differ between the Desktop and Lite versions of the operating system.

5.7.2.1 Raspberry Pi OS (Desktop)

Introducing how to adjust backlight brightness via the UI in Raspberry Pi OS (Desktop).

Preparation:

• The ED-HMI3010-185C is powered on, displaying normally, and has been properly connected to the network.

Steps:

1. Add EDATEC apt repository​ by executing the following commands sequentially in the terminal.

curl -sS https://apt.edatec.cn/pubkey.gpg | sudo apt-key add -
echo "deb https://apt.edatec.cn/raspbian stable main" | sudo tee /etc/apt/sources.list.d/edatec.list
sudo apt update

2. Install the software toolkit.

sudo apt install -y ed-ddcci-mib-tool

3. Click the icon in the top-left desktop corner. Then select to "​System Tools" → "EDATEC Monitor".

4. Adjust brightness and volume using the slider in the "​EDATEC Backlight"​ panel.

TIP

Support executing the sudo ed-ddc-ui command in the terminal window to open the "EDATEC Backlight" panel.

5.7.2.2 Raspberry Pi OS (Lite)

Adjusting brightness and volume via CLI on Raspberry Pi OS (Lite).

Preparation:

• The ED-HMI3010-185C is powered on, displaying normally, and has been properly connected to the network.

Steps:

1. Add EDATEC apt repository​ by executing the following commands sequentially in the terminal.

curl -sS https://apt.edatec.cn/pubkey.gpg | sudo apt-key add -
echo "deb https://apt.edatec.cn/raspbian stable main" | sudo tee /etc/apt/sources.list.d/edatec.list
sudo apt update

2. Install the software toolkit.

sudo apt install -y ed-ddcci-mib-tool

3. Execute the following commands to query the current brightness level and volume level settings separately.

• Query current brightness level:

sudo ed-ddc-server brightness read

• Query current volume level:

sudo ed-ddc-server volume read

4. Execute the following commands to set brightness level and volume level as required.

• Set brightness level:

sudo ed-ddc-server brightness write -v X

Where X represents the brightness level with a range of 0~100.

• Set volume level:

sudo ed-ddc-server volume write -v Y

Where Y represents the volume level with a range of 0~100.