KD4Z Toolkit - MD380tools VM for VirtualBox, VMWare or just BASH Warren Merkel, KD4Z

From github project https://github.com/KD4Z/md380tools-vm

Current Version: 4.00 (after glv is run)

Image file updated: 12/25/2017 Version 4.0

Installation PDF updated: 01/28/2017

Version 4 Release Notes: https://github.com/KD4Z/md380tools-vm/blob/master/KD4Z_Toolkit_Version_4.0_enhancement_notes.pdf

Follow the installation directions in the PDF found here:

[English] https://github.com/KD4Z/md380tools-vm/raw/master/MD380tools_VM_installation_3.08.pdf

[Dutch] https://github.com/KD4Z/md380tools-vm/raw/master/Handleiding_NL_1.04.pdf

[German] https://github.com/KD4Z/md380tools-vm/raw/master/MD380tools_VM_installation_3.08_DE_(OE7BSH).pdf

[Italian] https://github.com/KD4Z/md380tools-vm/raw/master/MD380tools_VM_installation_3.08_IT_(IU5FHF).pdf

You only need to download a couple of files from this github site! The rest are used by the installed VM.

1. The Installation instructions pdf. (choose one above)
2. The Image File for the Virtual Machine.

These instructions describe how to install software on your Windows or Mac, that runs linux in a Virtual Machine environment. You don't need to know anything about linux to use it! Don't worry, the Installation steps seem to be quite long....just take them a one at a time. I have tried to make it easy on both you and me (less emails), so I've explained a lot of things you need need to know.

If you are linux savy, and would rather just use the scripting framework on your existing Linux box, see the linux install pdf document for brief installation instructions. This allows you to use your existing linux environment such as Debian, Ubuntu or Raspian on a Raspberry Pi. This guide will discribe how to install exactly the same scripting framework used in the VM. Once installed, it will self update in the same way the VM does.

See MD380tools_Menu_installation_on_native_linux_KD4Z.pdf here:
https://github.com/KD4Z/md380tools-vm/raw/master/MD380tools_Menu_installation_on_native_linux_KD4Z.pdf If you run into something I missed in this brief document, please forward that information on to me so I can update the document.

Facebook Support group, specializing in Dutch and English, courtesy of Rob van Rheenen, PD0DIB. https://www.facebook.com/groups/KD4ZToolkit/

What does this thing do?

The VM allows you to create the latest firmware for the MD-380 / MD-390 series of radios from Tytera (TYT) and Retevis RT3/RT8. It leverages the MD380tools project by Travis Goodspeed found elsewhere on github. It also downloads the whole dmr-marc contact database into the radio.

The VM provided provides simple single-word menu that is easy to use, and does all of the heavy lifting of installing the MD380tools project files.

Other interesting tweaks in this VM make it stand out as producing better results than just using other scripting or VM solutions.

• Automatically updates itself to the latest scripting and source code. You will always, ALWAYS have the absolute latest features.
• That means you only have to install this stuff ONE TIME!
• Pulls current main branch of source directly from Travis Goodspeed's Github respository.
• Single, one word commands to do the primary functions.
• Builds the "firmware" for radios having GPS and not having GPS. No need to download firmware from websites.
• Builds the contact list on-the-fly, directly from the dmr-marc database. Currently over 61K records worldwide.
• After running one command, the computer with the VM can be offline from Internet, and still write firmware and the User DB (contact data) to the radio.
• Larger font on contact name with redline data separator in User DB modes / green line separator in Talker Alias modes.
• More detail in EU contact data.
• Support for private DMR IDs automatically appended in with the dmr-marc contact database. (via a static file or from an ftp server)
• Scripting framework functions can be extended for custom actions before firmware compilation, after compilation, and after contact data is downloaded.
• Commands to save and restore firmware and contact data in snapshots. Restores to a stable firmware if the latest gets sideways.
• Screen language defaults to English. Six alternate languages available: Dutch, Portuguese, Spanish, Italian, German and French!
• Lite weight version for Linux! The scripting is all done using Bash scripts. You can install just the scripting on Linux or Raspberry Pi. Creates the exact same firmware.

Be sure to read the installation completely before emailing questions! 99% of all questions are answered in the installation PDF. If you are stuck, join the Facebook group mentioned above for help.

It's your choice. You can use Oracle Virtual Box or VMware player to run this VM image. Choose one, and select the correct image download below.

** Please update to the most recent version of Oracle VirtualBox before installing this image

• For the VirtualBox Appliance image file, use these links

Single file download:

#Mirror 1:

[Single Download 1.2 Gigs] (https://drive.google.com/file/d/1YkPIsmj_vsoYK9ALIaKGDNRVGZ70lvrI/view?usp=sharing)

or

#Mirror 2:

[Single Download 1.2 Gigs] TBA

Use one of the above links, or download all 4 links below. **Don't do both!

Parts - Use these links if you have trouble downloading the large file above.

[Part 1] (https://drive.google.com/file/d/1aPXwDEMSZufvzvma_q9uIF6AUV2i9crB/view?usp=sharing)

[Part 2] (https://drive.google.com/file/d/16mPYbtyIrK49IlBqwmh7kqSf8y_D3aGY/view?usp=sharing)

[Part 3] (https://drive.google.com/file/d/1C8P00s_QeP_GEr8_h80kxG8VEOFBU1aM/view?usp=sharing)

[Part 4] (https://drive.google.com/file/d/1IvE_a_KtVgHf75UdY6qX4MBGCLfHb7Gg/view?usp=sharing)

[Part 5] (https://drive.google.com/file/d/11MhNJLfSrIkdpzov1irY3gQwJyC9Hlp5/view?usp=sharing)

[Part 6] (https://drive.google.com/file/d/1Emr5QxVP0FBNi2LfRJaw3PELCtSJxUuR/view?usp=sharing)

For the part files, download each one. You will need to use the 7-zip program to extract them back into the actual OVA Appliance file.

Get 7-Zip here: http://www.7-zip.org/download.html

Install 7-Zip, and then Right-Click on the first part file, find the 7-Zip menu, and choose the extract option. You will end up with a single, large ".OVA" file. This file is imported into the Virtual Box software.

• If you decide to use VMware instead of VirtualBox, use the following links, as this image has been pre-converted for easier import into VMWare.

Single file download for VMWare image:

https://drive.google.com/open?id=0BwED_-BHnZjSWklsNjY3VHBqMVE

-OR Download the VMWare image in parts - don't download these if you download from the single link above.

Parts - Use these links if you have trouble downloading the large file above.

[Part 1] - https://drive.google.com/file/d/0BwED_-BHnZjSdERwY1BHc1Y3ekk

[Part 2] - https://drive.google.com/open?id=0BwED_-BHnZjSYnZEeXJHcjh5R3c

[Part 3] - https://drive.google.com/open?id=0BwED_-BHnZjSb3NzSE41azhzN3M

[Part 4] - https://drive.google.com/open?id=0BwED_-BHnZjSNmlOMTJvT3l4VWM

• Multiple language support. Currently 6 alternate languages are supported.

  Dutch (enable with: touch lang.nl ) Courtesy of PD0DIB

  Portuguese (enable with: touch lang.pt ) Courtesy of CS7AGH

  Italian (enable with: touch lang.it ) Courtesy of IW0QPP

  Spanish (enable with: touch lang.es ) Courtesy of EA8EE

  German (enable with: touch lang.de ) Courtesy of OE7BSH

  French (enable with: touch lang.fr ) Courtesy of ON7CL

  If you can help translate into other languages, create a branch, and modify the "strings" script (found here), and request a pull. Or send me the new language section in email.

  Power Users! You can customize the build process using your own bash scripting. Callouts to user scripts are provided. prior to glv, after source download (before the Make), and after glv is completed. So knock yourself out!

  A couple of quick notes regarding recent discoveries:

  1 - Unless you are using a PS2 style mouse (not a USB mouse), always configure Virtual Box to use a PS/2 mouse! That way, it won't try to steal your USB mouse. The VM doesn't need your mouse anyway. In Oracle VM VirtualBox Manager, go to Settings / System / Change the "pointing device" to "PS/2 mouse"

  2 - If you have a hotspot, be sure to either turn it OFF or change your radio to a different channel such as an analog channel, BEFORE trying to use the flash / flashgps / flashdb commands. The firmware flash cycle seems to be corrupted if the radio receives a signal during the flash steps. If your radio reboots itself after first powering it up, remember this tip!

  KD4Z