KB8PMY
/
MMDVM_HS
mirror of https://github.com/juribeparada/MMDVM_HS.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updating some comments and text

Browse Source
pull/14/head
Andy CA6JAU 9 years ago
parent 2c812991f7
commit a68946e0b2
3 changed files with 42 additions and 41 deletions
Show Stats Download Patch File Download Diff File

60
BUILD.md
Unescape View File

@ -7,14 +7,14 @@ Due and Zero) and Teensy (3.1, 3.2, 3.5 or 3.6) are supported.
# Index # Index
- ZUMSpot RPi - ZUMspot RPi
- ZUMSpot Libre Kit - ZUMspot Libre Kit
- ZUMSpot USB - ZUMspot USB
- Makefile options - Makefile options
- Config.h options - Config.h options
- Pinout definitions - Pinout definitions
# ZUMSpot RPi # ZUMspot RPi
Download latest Raspbian image and install to a micro SD Download latest Raspbian image and install to a micro SD
@ -72,7 +72,7 @@ Reboot your RPi:
sudo reboot sudo reboot
### Build de firmware and upload to ZUMSpot RPi ### Build de firmware and upload to ZUMspot RPi
Install the necessary software tools: Install the necessary software tools:
@ -111,7 +111,7 @@ Build the firmware:
make make
Upload the firmware to ZUMSpot RPi board: Upload the firmware to ZUMspot RPi board:
sudo make zumspot-pi sudo make zumspot-pi
@ -131,7 +131,7 @@ Execute MMDVMHost:
./MMDVMHost MMDVM.ini ./MMDVMHost MMDVM.ini
# ZUMSpot Libre Kit # ZUMspot Libre Kit
## Windows ## Windows
@ -145,7 +145,7 @@ Download STM32duino (Arduino for STM32) from this URL:
https://github.com/rogerclarkmelbourne/Arduino_STM32/tree/ZUMspot https://github.com/rogerclarkmelbourne/Arduino_STM32/tree/ZUMspot
Unzip and change the extracted folder name "Arduino_STM32-ZUMSpot" to "Arduino_STM32" Unzip and change the extracted folder name "Arduino_STM32-ZUMspot" to "Arduino_STM32"
Copy Arduino_STM32 folder in: Copy Arduino_STM32 folder in:
@ -155,12 +155,12 @@ Install the USB bootloader to STM32F103. Follow the instructions:
https://github.com/rogerclarkmelbourne/Arduino_STM32/wiki/stm32duino-bootloader https://github.com/rogerclarkmelbourne/Arduino_STM32/wiki/stm32duino-bootloader
Connect the ZUMSpot Libre Kit to your PC. Install the USB Mapple driver using the bat file Connect the ZUMspot Libre Kit to your PC. Install the USB Mapple driver using the bat file
(you may also check http://wiki.stm32duino.com/index.php?title=Windows_driver_installation): (you may also check http://wiki.stm32duino.com/index.php?title=Windows_driver_installation):
My Documents/Arduino/hardware/Arduino_STM32/drivers/win/install_drivers.bat My Documents/Arduino/hardware/Arduino_STM32/drivers/win/install_drivers.bat
You have to be sure that Windows detect your ZUMSpot as an USB serial device COMx (please You have to be sure that Windows detect your ZUMspot as an USB serial device COMx (please
see Windows Device Manager). see Windows Device Manager).
Download the source (zip file) of MMDVM_HS from: Download the source (zip file) of MMDVM_HS from:
@ -231,7 +231,7 @@ Build the firmware with bootloader support:
make bl make bl
Upload bootloader and firmware to ZUMSpot Libre Kit, using serial port first (you Upload bootloader and firmware to ZUMspot Libre Kit, using serial port first (you
are using an USB-serial converter with device name /dev/ttyUSB0). Move BOOT0 are using an USB-serial converter with device name /dev/ttyUSB0). Move BOOT0
jumper to 1, next press and release RESET and execute: jumper to 1, next press and release RESET and execute:
@ -259,7 +259,7 @@ Execute MMDVMHost:
./MMDVMHost MMDVM.ini ./MMDVMHost MMDVM.ini
# ZUMSpot USB # ZUMspot USB
## Windows ## Windows
@ -273,18 +273,18 @@ Download STM32duino (Arduino for STM32) from this URL:
https://github.com/rogerclarkmelbourne/Arduino_STM32/tree/ZUMspot https://github.com/rogerclarkmelbourne/Arduino_STM32/tree/ZUMspot
Unzip and change the extracted folder name "Arduino_STM32-ZUMSpot" to "Arduino_STM32" Unzip and change the extracted folder name "Arduino_STM32-ZUMspot" to "Arduino_STM32"
Copy Arduino_STM32 folder in: Copy Arduino_STM32 folder in:
My Documents/Arduino/hardware My Documents/Arduino/hardware
Connect the ZUMSpot USB to your PC. Install the USB Mapple driver using the bat file: Connect the ZUMspot USB to your PC. Install the USB Mapple driver using the bat file:
My Documents/Arduino/hardware/Arduino_STM32/drivers/win/install_drivers.bat My Documents/Arduino/hardware/Arduino_STM32/drivers/win/install_drivers.bat
(you may also check: http://wiki.stm32duino.com/index.php?title=Windows_driver_installation) (you may also check: http://wiki.stm32duino.com/index.php?title=Windows_driver_installation)
You have to be sure that Windows detect your ZUMSpot as an USB serial device COMx (please You have to be sure that Windows detect your ZUMspot as an USB serial device COMx (please
see Windows Device Manager) see Windows Device Manager)
Download the source (zip file) of MMDVM_HS from: Download the source (zip file) of MMDVM_HS from:
@ -354,7 +354,7 @@ Build the firmware with bootloader support:
make bl make bl
Upload the firmware to ZUMSpot USB: Upload the firmware to ZUMspot USB:
sudo make dfu devser=/dev/ttyACM0 sudo make dfu devser=/dev/ttyACM0
@ -382,12 +382,12 @@ Execute MMDVMHost:
- make bl: it builds a firmware with USB bootloader support. - make bl: it builds a firmware with USB bootloader support.
- make zumspot-pi: upload the firmware to a ZUMSpot RPi version (using internal RPi serial port) - make zumspot-pi: upload the firmware to a ZUMspot RPi version (using internal RPi serial port)
- make dfu [devser=/dev/ttyXXX]: upload firmware using USB bootloader. "devser" is optional, - make dfu [devser=/dev/ttyXXX]: upload firmware using USB bootloader. "devser" is optional,
and it corresponds to the USB serial port device name. This option permits to perform a reset and it corresponds to the USB serial port device name. This option permits to perform a reset
to enter to booloader mode (DFU). If you don't use "devser", you have to press the reset button to enter to booloader mode (DFU). If you don't use "devser", you have to press the reset button
of the ZUMSpot just before using this command. of the ZUMspot just before using this command.
- make serial devser=/dev/ttyXXX: upload standard firmware using serial port bootloader method. - make serial devser=/dev/ttyXXX: upload standard firmware using serial port bootloader method.
@ -416,10 +416,10 @@ USB programming (you have already transfered the USB bootloader):
make clean make clean
make bl make bl
sudo make dfu (reset ZUMSpot before) or sudo make dfu (reset ZUMspot before) or
sudo make dfu devser=/dev/ttyACM0 (/dev/ttyACM0 is the device name of ZUMSpot USB under Raspbian) sudo make dfu devser=/dev/ttyACM0 (/dev/ttyACM0 is the device name of ZUMspot USB under Raspbian)
ZUMSpot RPi (no USB support needed): ZUMspot RPi (no USB support needed):
make clean make clean
make make
@ -427,13 +427,13 @@ ZUMSpot RPi (no USB support needed):
# Config.h options # Config.h options
- #define PI_HAT_7021_REV_02: enable pinouts for first revision of ZUMSpot RPi. In general is - #define PI_HAT_7021_REV_02: enable pinouts for first revision of ZUMspot RPi. In general is
not used. not used.
- #define PI_HAT_7021_REV_03: enable pinouts support for ZUMSpot RPi or ZUMSpot USB. You have - #define PI_HAT_7021_REV_03: enable pinouts support for ZUMspot RPi or ZUMspot USB. You have
to enable this option if you have one of these products. to enable this option if you have one of these products.
- #define ADF7021_CARRIER_BOARD: enable this option if you have a ZUMSpot Libre Kit (Board with - #define ADF7021_CARRIER_BOARD: enable this option if you have a ZUMspot Libre Kit (Board with
modified RF7021SE and Blue Pill STM32F103). modified RF7021SE and Blue Pill STM32F103).
- #define ENABLE_ADF7021: add support for ADF7021 (all boards, enabled by default). - #define ENABLE_ADF7021: add support for ADF7021 (all boards, enabled by default).
@ -456,15 +456,15 @@ depending on your frequency offset this option will improve or not your BER rece
- #define ADF7021_AFC_POS: enable this option if you can not receive any signal after enable the - #define ADF7021_AFC_POS: enable this option if you can not receive any signal after enable the
ADF7021_ENABLE_4FSK_AFC option. ADF7021_ENABLE_4FSK_AFC option.
- #define STM32_USART1_HOST: enable direct serial host communication with ZUMSpot (using USART1 - #define STM32_USART1_HOST: enable direct serial host communication with ZUMspot (using USART1
PA9 and PA10 pins). Disable STM32_USB_HOST if you enable this option. Enable this if you have PA9 and PA10 pins). Disable STM32_USB_HOST if you enable this option. Enable this if you have
a ZUMSpot RPi. You don't need to enable this option if you will transfer the bootloader. a ZUMspot RPi. You don't need to enable this option if you will transfer the bootloader.
- #define STM32_USB_HOST: enable USB host communication with ZUMSpot (using STM32F103 USB - #define STM32_USB_HOST: enable USB host communication with ZUMspot (using STM32F103 USB
interface). Disable STM32_USART1_HOST if you enable this option. Enable this if you have interface). Disable STM32_USART1_HOST if you enable this option. Enable this if you have
a ZUMSpot USB or ZUMSpot Libre Kit. a ZUMspot USB or ZUMspot Libre Kit.
- #define ENABLE_SCAN_MODE: enable automatic mode detection in ZUMSpot. This is based on - #define ENABLE_SCAN_MODE: enable automatic mode detection in ZUMspot. This is based on
scanning over all enabled modes, and you could have some detection delay. Enabled by default. scanning over all enabled modes, and you could have some detection delay. Enabled by default.
- #define SEND_RSSI_DATA: enable RSSI reports to MMDVMHost. It is already converted to dBm. - #define SEND_RSSI_DATA: enable RSSI reports to MMDVMHost. It is already converted to dBm.
@ -478,7 +478,7 @@ personalities.
# Pinout definitions # Pinout definitions
## Pinout definitions for ZUMSpot Libre Kit ## Pinout definitions for ZUMspot Libre Kit
This is the carrier board or any board with RF7021SE + STM32F103. This is the carrier board or any board with RF7021SE + STM32F103.

11
Config.h
Unescape View File

@ -20,11 +20,11 @@
#define CONFIG_H #define CONFIG_H
// Select one board (STM32F103 based boards): // Select one board (STM32F103 based boards):
// 1) Initial release of ZUM-Spot Pi: // 1) Initial release of ZUMspot RPi:
// #define PI_HAT_7021_REV_02 // #define PI_HAT_7021_REV_02
// 2) ZUM-Spot USB and ZUM-Spot Pi HAT: // 2) ZUMspot USB and ZUMspot RPi HAT:
// #define PI_HAT_7021_REV_03 // #define PI_HAT_7021_REV_03
// 3) ZUM-Spot Libre Kit or board with modified RF7021SE and Blue Pill STM32F103 // 3) ZUMspot Libre Kit or board with modified RF7021SE and Blue Pill STM32F103
#define ADF7021_CARRIER_BOARD #define ADF7021_CARRIER_BOARD
// Enable ADF7021 support: // Enable ADF7021 support:
@ -58,9 +58,10 @@
// Send RSSI value: // Send RSSI value:
// #define SEND_RSSI_DATA // #define SEND_RSSI_DATA
// Enable Nextion LCD serial port repeater on USART2: // Enable Nextion LCD serial port repeater on USART2 (ZUMspot Libre Kit and ZUMspot RPi):
// #define SERIAL_REPEATER // #define SERIAL_REPEATER
// Enable Nextion LCD serial port repeater on USART1 (not compatible with ZUM-Spot Libre or STM32_USART1_HOST):
// Enable Nextion LCD serial port repeater on USART1:
// #define SERIAL_REPEATER_USART1 // #define SERIAL_REPEATER_USART1
// Enable P25 Wide modulation // Enable P25 Wide modulation

12
README.md
Unescape View File

@ -1,6 +1,6 @@
# Introduction # Introduction
This is the source code of ZUMSpot, personal hotspot (ADF7021 version of the MMDVM firmware), based on Jonathan G4KLX's MMDVM software. This firmware supports D-Star, DMR, System Fusion and P25 digital modes. This is the source code of ZUMspot, personal hotspot (ADF7021 version of the MMDVM firmware), based on Jonathan G4KLX's MMDVM software. This firmware supports D-Star, DMR, System Fusion and P25 digital modes.
This software is intended to be run on STM32F103 microcontroller. You can build this code using Arduino IDE with STM32duino package, or using "make" with ARM GCC tools. Also, Arduino with 3.3 V I/O (Arduino Due and Zero) and Teensy (3.1, 3.2, 3.5 or 3.6) are supported. This software is intended to be run on STM32F103 microcontroller. You can build this code using Arduino IDE with STM32duino package, or using "make" with ARM GCC tools. Also, Arduino with 3.3 V I/O (Arduino Due and Zero) and Teensy (3.1, 3.2, 3.5 or 3.6) are supported.
@ -10,7 +10,7 @@ This software is licenced under the GPL v2 and is intended for amateur and educa
Please see BUILD.md for more details, and also MMDVM Yahoo Groups. Please see BUILD.md for more details, and also MMDVM Yahoo Groups.
## ZUMSpot Libre Kit (under Linux Raspbian) ## ZUMspot Libre Kit (under Linux Raspbian)
Install the necessary software tools: Install the necessary software tools:
@ -28,11 +28,11 @@ Build the firmware with USB bootloader support (the default Config.h is OK for L
make bl make bl
Upload the firmware to ZUMSpot Libre Kit using the USB port (your Libre Kit has the bootloader already installed): Upload the firmware to ZUMspot Libre Kit using the USB port (your Libre Kit has the bootloader already installed):
sudo make dfu devser=/dev/ttyACM0 sudo make dfu devser=/dev/ttyACM0
## ZUMSpot RPi ## ZUMspot RPi
### Enable serial port in Raspberry Pi 3 or Pi Zero W ### Enable serial port in Raspberry Pi 3 or Pi Zero W
@ -61,7 +61,7 @@ Reboot your RPi:
sudo reboot sudo reboot
### Build de firmware and upload to ZUMSpot RPi ### Build de firmware and upload to ZUMspot RPi
Install the necessary software tools: Install the necessary software tools:
@ -98,7 +98,7 @@ Build the firmware:
make make
Upload the firmware to ZUMSpot RPi board: Upload the firmware to ZUMspot RPi board:
sudo make zumspot-pi sudo make zumspot-pi

Write Preview
Loading…
Cancel
Save

Powered by TurnKey Linux.