SETUP OF KB5RAB IMAGEGuide to Setup and Operation of KB5RAB Raspberry Pi Image

1

SETUP OF KB5RAB PI IMAGE• Download image from link to Facebook document

• https://www.facebook.com/notes/brandmeister-talkgroup-3148/link-to-latest-kb5rab-raspberry-pi-image/171532783251102

• There is now only one image including DMR, DSTAR and Fusion support

• Download Win32diskimager to write image (Formatter if needed) Alternative Image burner Etcher (linux Mac also)• https://sourceforge.net/projects/win32diskimager/

• https://www.sdcard.org/downloads/formatter_4/

• https://etcher.io/

• Download Real VNC Viewer and Advanced IP Scanner• https://www.realvnc.com/download/viewer/

• http://www.advanced-ip-scanner.com/

2

SETUP OF KB5RAB PI IMAGE• Image Contents

• Image file itself .img

• IRCDDBGateway DSTAR setup

• MMDVM.ini settings

• Readme First document

• Overall setup instructions for DMR

• Using VNC remote control

• Burn Image Using preferred method• 16GB high speed microSD recommended

• Start program browse to select image file

• Verify the drive letter of your SD card

• Select Write

• Eject and remove SD card after write

• Plug the Pi in to your Router wired port

• Install Card in Pi and power up

• Check Router for IP address of PI or

• Run Advanced IP scanner to find PI• IP scanner will default to your local network

• Hit scan and look at list to find Raspberrypi

3

SETUP OF KB5RAB PI IMAGE

• Run Real VNC Viewer

• No install required just double click the download

• Select File New Connection

• Input IP address of Pi from before In VNC Server

• Input Name you want to call the connection

• Double click the new entry to open the connection

• Input password = raspberry

• Select OK to connect to Pi

4

SETUP OF KB5RAB PI IMAGE

• Once you have the PI screen showing• Click the Warning message to acknowledge

• You can change password if you wish

• Select Raspberry Pi menu top left• Select Raspberry Pi Configuration from Preferences

• On System Tab you can set password

• On localization tab you can change• Locale

• Time Zone

• Keyboard type

• Expand file system to user Full SD card• Open Terminal and type sudo raspi-config

• Choose option 7 Advanced Options

• Choose option A1 Expand File System

• Hit enter and reboot pi

5

SETUP OF KB5RAB PI IMAGE

• Setup you WIFI network if desired• Click WIFI icon on top right

• You will see list of available networks

• Select the desired and input password

• You can setup phone or mobile hotspot as well

• Pi will switch to any network available after setup

• Review the ReadmeFirst.txt on desktop• Much info about image and setup is in here

• Check the Ham Radio Shortcuts folder• The first time you open it will empty

• Just close and open again

• This only happens after a fresh boot

• Links for most functions on the image are here

• You can also use the Ham Radio Menu• Located on Raspberry Pi menu

• The same functions from desktop folder are here

6

SETUP OF KB5RAB PI IMAGE

• Menu MMDVMHost• Controls MMDVMHost service Stop Start Restart

• Link to Edit mmdvm.ini file for settings

• MMDVM Connect screen Connects to running DVM service if screen is not visible but running

• Menu IRCDDBGateway• Link to Configure gateway for DSTAR

• Link to run IRCDDBGateway program

• Menu MD380Tools• Readme for MD380tools Custom firmware

• Update MD380tools to latest version from Github

• Load firmware to Non GPS Radio

• Flash User Database to Radio after firmware loaded

• Load firmware in GPS Radio version

• Menu Updates• These scripts will update each program or file

• DMRIDs.dat are auto update at 0200 daily

• YSFHosts.txt are auto updated at 0100 daily

• All others are done as needed by selecting link

7

SETUP OF KB5RAB PI IMAGE

• Menu Misc• BlueDV (Starts BlueDV Linux Beta)

• BMXTG Dialer (STG dialer program for DV4Mini)

• DV4MF2 (Starts DV4MF2 Panel Ver 12)

• DV4Mini (Starts DV4mini software Version Mar 06-17)

• Edit MMDVMDashboard config

• Settings for dashboard (change time zone etc)

• Edit startapps.sh

• Used to enable auto start of IRCDDB or YSF Gateway

• Menu YSFGateway• Edit YSFGateway.ini (settings for YSFGateway)

• Edit YSFHosts.txt (host file of YSF reflectors)

• Start the YSFGateway service

• Stop the YSFGateway service

8

SETUP OF KB5RAB PI IMAGE

• Changing Time zone on Dashboard• Click in Menu Misc. Edit MMDVMDashboard config

• The config.php file for dashboard will open

• Change define("TIMEZONE", "America/Chicago");

• Change this entry to your desired time zone

• Check the website below for the syntax of TZ

• https://en.wikipedia.org/wiki/List_of_tz_database_time_zonesEdit MMDVMDashboard config

• Enable or Disable Auto Start of IRCDDBGateway or YSFGateway

• Click Edit startapps.sh in the Misc. Ham Radio Menu

• This opens the file start_apps.sh

• Neither apps are enabled by default

• If using Fusion enable YSFGateway

• Remove # from this line

• If using DSTAR enable IRCDDBGateway

• Remove # from this line

• To disable MMDMVHost start on boot• Open Terminal window and type the following

• sudo systemctl disable mmdvmhost

• sudo systemctl mask mmdvmhost

• Reboot

• To enable use sudo systemctl unmask mmdvmhost9

SETUP OF KB5RAB PI IMAGE• By default image is setup with DMR only enabled in MMDVM

• MMDVM is capable of DSTAR and or Fusion as well

• The same Frequency must be used for all modes enabled

• MMDVMhost listens on the network and RF for any enabled mode• It switches to the first mode received from either side

• It stays in that mode until the ModeHang time expires after a transmission

• There are separate hang times for Network and RF side

• It can only receive one mode at a time so any other will not be heard

• It is best not to connect to a busy reflector and DMR TG at the same time

10

SETUP OF KB5RAB PI IMAGE• Setup of image requires editing several config files

• All modes require editing of mmdvm.ini

• DSTAR requires editing IRCDDBGateway config

• Fusion requires editing YSFGateway.ini

• For more details of DSTAR config of IRCDDBGateway• See the document IRCDDBGateway DSTAR setup included in zip file

• There is another good document on BM 3148 FB files section

• DStar_DMR on KB5RAB image_2-7-17.pdf

• Editing YSFGateway.ini only requires a few entries• Details on these settings are at the end of Readme Frist with YSF.pdf

• The remaining discussion will cover mmdvm.ini setting• The document MMDVM.ini settings.pdf will be covered now

• You must stop MMDVM service before editing the ini file

11

mmdvm.ini entries in default file

Red Must change or verifyBlue optional can change if neededBlack do not change # in front of a line comments it out

[General]Callsign=KXXXXXY Put your callsign here

Timeout=320 Timeout for transmissions in seconds change if wanted

Duplex=0 This should stay 0 for hotspot setup

# ModeHang=15

RFModeHang=10 Time to stay in last mode from RF before listening for all modes again

NetModeHang=3Time to stay in last mode from Net side before listening for all modes again

Display=NoneSet here if you want to use a supported display for MMDVM data i.e. Nextion

Daemon=0 Leave this at default

[Info]RXFrequency=432550000 Frequency in HZ RX and TX must be the same for Hotspot

TXFrequency=432550000 Frequency in HZ RX and TX must be the same for Hotspot

Power=1 Leave this at default

Latitude=0.0You can put your actual Lat and Long in here if you want to show up on BM map

Longitude=0.0You can put your actual Lat and Long in here if you want to show up on BM map

Height=0Location=My location You can put your location here if you like

Description=MMDVM-DVMega You can put anything here you like

URL=www.qrz.com/db/KBXXXX You can put your QRZ link to callsign if you like

[Log]# Logging levels, 0=No logging Do not change these log settings unless you have a reason to.

DisplayLevel=2 The Dashboard needs these to get data.

FileLevel=2FilePath=/home/pi/MMDVMHostlogFileRoot=MMDVM

[CW Id]Enable=0 This option only works on repeaters not on DVMega

Time=10

[DMR Id Lookup]File=DMRIds.dat Leave at default

Time=24

[Modem]

12

Port=/dev/ttyAMA0 This is the correct modem settings for DVMega

# Port=/dev/ttyACM0 Leave the remaining settings as default for this section

# Port=\\.\COM3# Port=/dev/ttyUSB0TXInvert=1RXInvert=0PTTInvert=0TXDelay=100DMRDelay=0RXLevel=50TXLevel=50# CWIdTXLevel=50# D-StarTXLevel=50# DMRTXLevel=50# YSFTXLevel=50# P25TXLevel=50OscOffset=0RSSIMappingFile=RSSI.datDebug=0

[UMP]Enable=0 Leave at default settings

# Port=\\.\COM4Port=/dev/ttyACM1

[D-Star]Enable=0 If you want to use DSTAR set this =1

Module=BUse Module B for UHF and C for VHF remember for your DSTAR setup

SelfOnly=0 Option if you country requires hotspot to limit to your callsign only

[DMR]Enable=1 Leave set at 1 to enable DMR

Beacons=0 Leave as default

Id=123456You must put your DMR ID here If you are using multiple hotspots you can add an extra digit along with your 7 digit DMR ID to set them apart

ColorCode=1Color code if you change make sure and set on your code plug to whatever you want

SelfOnly=0 Option if you country requires hotspot to limit to your callsign only

EmbeddedLCOnly=1This will disable Talker Alias being send over RF when set =1. Leave disabled unless you are sure your radio supports TA

DumpTAData=0This option will send Talker Alias to the log files and the MMDVMHost Dashboard. 0 off 1 to send to logs

# Prefixes=234,235 Leave the remaining items as default in this section

# Slot1TGWhiteList=# Slot2TGWhiteList=

13

CallHang=3TXHang=4

[System Fusion]Enable=0 If you want to enable System Fusion set this =1

RemoteGateway=0

[P25]Enable=0 P25 not setup on this image leave at default

NAC=293

[D-Star Network]Enable=0 Set this to 1 if you are using DSTAR

GatewayAddress=127.0.0.1 Leave the other lines at default

GatewayPort=20010LocalPort=20011Debug=0

[DMR Network]Enable=1 Leave at 1 if using DMR

You must set the address for your DMR master server here uncomment or change the one you want make sure all others have # in front to comment

Address=central.brandmeister.us Master 3102 Dallas

# Address=east.brandmeister.us Master 3101 in NY

# Address=west.brandmeister.us Master 3103 in CA

# Address=64.94.238.196 Master 3108 in Atlanta

# Address=brandmeister.pd0zry.ampr.org Master in Netherlands

Port=62031 Leave at default

Jitter=300 Leave at default

# Local=3350 Leave at default

Password=passw0rdThis is the correct password for the USA servers if yours is different set here

# Options= Leave at default

Slot1=0 Leave at default

Slot2=1 Leave at default

Debug=0 Leave at default

[System Fusion Network]Enable=0 Set to 1 if you want to use System Fusion

LocalAddress=127.0.0.1 Leave the other settings at default

LocalPort=3200GwyAddress=127.0.0.1GwyPort=4200Debug=0

[P25 Network]

14

Enable=0 P25 not setup on this image leave at 0

GatewayAddress=127.0.0.1GatewayPort=42020LocalPort=32010Debug=0

[TFT Serial]All of the remaining settings are for the various screens available to setup for use with mmdvmhost

# Port=modem Leave the at default unless you have other instructions for these.

Port=/dev/ttyAMA0Brightness=50

[HD44780]Rows=2Columns=16

# For basic HD44780 displays (4-bit connection)# rs, strb, d0, d1, d2, d3Pins=11,10,0,1,2,3

# Device address for I2CI2CAddress=0x20

# PWM backlightPWM=0PWMPin=21PWMBright=100PWMDim=16

DisplayClock=1UTC=0

[Nextion]# Port=modem# Port=/dev/ttyAMA0Port=/dev/ttyUSB0Brightness=50DisplayClock=1UTC=0IdleBrightness=20

[OLED]Type=3Brightness=0Invert=0

[LCDproc]

15

Address=localhostPort=13666#LocalPort=13667DimOnIdle=0DisplayClock=1UTC=0

16