Differences

This shows you the differences between two versions of the page.

--- voiceoutput [2017/05/21 05:43]
Deal57 [Software Configuration] Added details for using DFPlayer
+++ voiceoutput [2018/05/12 09:27] (current)
Moeder [Setting up the emulator for voice alerts]
@@ Line 1: / Line 1: @@
 ===== Adding voice support =====
 The unmodified Devo transceivers only support sound output using the internal buzzer. By adding a cheap voice module and a speaker, you can enable deviation to play custom mp3 files on switch action, telemetry alarm and many other things. The MP3 files used are located on a MicroSD card in an additional hardware module, the Devo transmitter needs a //voice.ini// within the //media// folder which contains information about the files available on the MicroSD card and each files duration. For details concerning usage, please refer to the manual.
+Voice alerts are available by installing the appropriate hardware and the latest nightly [[http://deviationtx/downloads-new|Deviationtx.com Downloads]] for your TX.  The voice feature runs on all Deviation platforms except for Devo7e due to memory limitations.
+There are custom builds available for Devo 7e users with standard GUI disabled but voice enabled. This build can play the voice alerts, but the voice configuration editor menu is not available due to RAM space limitations.  The [[voiceoutput#Setting up the emulator for voice alerts|7e Emulator]] available together with the custom 7e build has these features so that voice configurations and models can be edited. Models can also be edited manually on a PC.
 ==== Audio players supported ====
 Currently the following MP3 modules are supported:
@@ Line 62: / Line 67: @@
 The serial signal is not available at the trainer port, but rather on a neat pin header labeled "TX/RX" on the Main board - perfect for internal installation of a DFPlayer module.
+=== Powering the Voice Alert Module ===
+The DFPlayer module can be powered by 3.3v to 5v, with 4.2v recommended.  A fully charged 1S, 3.6v lipo provides adequate voltage.  At full volume the board may use 70ma+ momentarily, and in standby it is rated at 20ma.  In testing, a 200mah 3.6 lipo lasted over two weeks of regular use (15-20 min/day).
+Although not required, the Pololu S7V8A adjustable stepup/stepdown regulator can ensure that the voltage is consistent and stable.  It can be wired to a 3.3 or 5v switched source near the power circuits (the location of which will vary by TX) to avoid affecting other electrical needs of the transmitter.  The S7V8A can also be wired directly to the battery-in port, provided that the -SHUTDOWN is connected (varies by TX).
+Here are some example power locations for transmitters. The forums may provide additional information as more pilots adopt the voice alerts feature.
+  *   In the Devo 12e, connect to the Vdd and ground on the Debug port.  This may be a good power source for the Devo 10 as well.
+  *   In the Devo 6s, the Vdd and ground on the Debug port are convenient, and can be used if there are not other add-ons in use (such as the Multiprotocol board or other transmitter modules).
+  *   In the Devo 7e power is a challenge: search the forum for more details.  [[https://www.deviationtx.com/forum/6-general-discussions/6246-devo-7e-voltage-supply?start=20#53017|This excellent post]] is a good place to start.
+==== Jumper T8SG V2 ====
+The Jumper T8SG V2 and T8SG V2 plus are already prepared for installation of a DFplayer module.
+The picture shows the necessary parts to get started. Basically any speaker with 22 mm diameter works fine.
+{{ :hardware:voice:voice-mod-parts-01.jpg?600 |}}
+First, you need to remove 2 pins on the left and 6 pins on the right side of the DFplayer module as depicted below.
+{{ :hardware:voice:mp3-dfplayer-mini-01.jpg?600 |}}
+Now you can solder module to the T8SG V2 PCB. You will have to unmount the main PCB to solder the pins on the bottom side.{{ :hardware:voice:dfplayer-min-01.jpg?600 |}}
+The speaker can be mounted beneath the RF module at the top of the case and wired to the adjacent free header with a PH1.25 mm connector or directly wired to pins on the DFplayer module.
+{{ :hardware:voice:speaker-22x3.jpg?600 |}}
+To fit the battery compartment, you will have to cut along the prepared lines with a sharp knife or a small saw to make room for the DFplayer before reassembling the transmitter.
+{{ :hardware:voice:battery-comp-01.jpg?600 |}}
+Follow the software instructions below and setup hardware.ini for DFplayer and UART5 usage:
+<code ini>
+voice=dfplayer
+voice-uart5=1
+</code>
 ==== Software Configuration ====
@@ Line 67: / Line 99: @@
 === Install and Configure the voice alert sound files ===
+== Using the DFPlayer MicroSD card ==
 The DFPlayer uses a small MicroSD card with the standard USB Storage Device file system.  Use a MicroSD card with a capacity of at least 64MB -- yes, that's MEGABYTE, not GIGABYTE, so pretty much any old MicroSD card will be sufficient.  The MicroSD card can be formatted and accessed from a PC or Mac.  Prior to using in the Voice Alerts system, the MicroSD card must be formatted and loaded with the correct voice alert files.
-USB Format and Access: The DFPlayer MicroSD card can be formatted on your PC or MAC, after which files can be dragged-n-dropped as needed.  If the card is formatted and inserted into the DFPlayer, the card is also accessible from your PC or Mac by connecting to the DFPlayer USB port.  Either way, the card appears as a USB storage device on your PC or Mac.
+== USB Format and Access: ==
+The DFPlayer MicroSD card can be formatted on your PC or MAC, after which files can be dragged-n-dropped as needed.  If the card is formatted and inserted into the DFPlayer, the card is also accessible from your PC or Mac by connecting to the DFPlayer USB port.  Either way, the card appears as a USB storage device on your PC or Mac.
 {{:hardware:voice:usb_drive_root_folder.png?|}}
-Voice Files: Deviation software nightly builds do not include the voice files, and the user must also download a basic set of voice alerts.  The files are currently available in the [[http://deviationtx/downloads-new|Deviationtx.com Downloads]] folder under [[https://www.deviationtx.com/downloads-new/category/705-moeder-voice-alerts|Test Builds/[Moeder]voice_alerts]] and are available in English, French and German.  An expanded set of English voice alerts is also available.  Each zip file includes the required MP3 Folder and a voice.ini file catalog.
+== Voice Files: ==
+Deviation software nightly builds do include the voice features since April 2017, but the user must also download a set of voice alerts. The files are currently available in the [[http://deviationtx/downloads-new|Deviationtx.com Downloads]] folder under [[https://www.deviationtx.com/downloads-new/category/1010-moeder-voice-packs|Test Builds/[Moeder]voice_packs]] and are available in English, French and German. Each zip file includes the required MP3 Folder and a voice.ini file catalog.
+You can also use the [[https://moeder.pythonanywhere.com/voicepacker/default/index|Deviation Voicepacker]] service to create your own custom voice sets. This service will continue to evolve.
 The files for the DFPlayer are saved using MP3 format and are contained in the //\MP3// folder on the MicroSD card.  The MicroSD must be set up with the //\MP3// folder and all the voice alert files must be in that folder.  No other files or folders need to be on the card, so the card can be a small as 64MB (the actual disk storage for the largest file set is under 2MB).
@@ Line 78: / Line 115: @@
 {{:hardware:voice:usb_drive_mp3_folder.png?|}}
-== Deviation Voice Media catalog file voice.ini ==
-The voice alert files are cataloged in a file called //voice.ini// that must be copied to the deviation \media folder on the transmitter.  The //voice.ini// file contains lines that correspond to each voice alert file (ex: "0=Welcome to deviation,1617") that map the MP3 file name and duration for Deviation.  Each set of deviation voice alert files must have a //voice.ini// file to match.
-{{:hardware:voice:voice_ini_file_example.png?|}}
-== Deviation transmitter software changes ==
+=== Deviation transmitter software changes ===
-Once the voice alerts hardware is available and the //voice.ini// file is installed on the transmitter, there are two changes required to the transmitter software.  The first change is to update the //hardware.ini// file to include a line(s) defining the voice player hardware.  For the DFPlayer, use "voice=dfplayer" and remove the semicolon from the first character of the line.  Use "voice=audiofx" for the AudioFX players.  If your audio device is wired to the UART5 port (only available on the Devo7e-256), you must also add "voice-uart 5=1" and remove the semicolon.
+Once the voice alerts hardware is available and files are on the player, there are three changes required to the transmitter software.
+== Update hardware.ini file ==
+The first change is to update the //hardware.ini// file to include a line(s) defining the voice player hardware.  For the DFPlayer, use "voice=dfplayer" and remove the semicolon from the first character of the line.  Use "voice=audiofx" for the AudioFX players.  If your audio device is wired to the UART5 port (only available on the Devo7e-256), you must also add "voice-uart 5=1" and remove the semicolon.
 \\
 The used audio player (and possibly the special wiring for Devo7e-256) has to be enabled in //hardware.ini// located in the root directory of your transmitter:
@@ Line 92: / Line 129: @@
 ;Audio player connected to UART (Devo12/S internally, others via trainer port): audiofx, dfplayer
 ;voice=
+voice=dfplayer
 ;
 ;Enable if audio device is wired to uart5 instead of ppm on devo7e-256
@@ Line 97: / Line 135: @@
 ;
 </code>
+== Deviation Voice Media catalog file voice.ini ==
+The voice alert files are cataloged in a file called //voice.ini// that must be copied to the deviation \media (\mymedia on Devo12(S)) folder on the transmitter.  The //voice.ini// file contains lines that correspond to each voice alert file (ex: "0=Welcome to deviation,1617") that map the MP3 file name and duration for Deviation.  Each set of deviation voice alert files must have a //voice.ini// file to match.
+{{:hardware:voice:voice_ini_file_example.png?|}}
+== Update Model.ini files ==
+The third change to the deviation transmitter is to configure the sounds in each model by using the voice config menu of each model (except for devo7e) or by directly editing the model.ini.
+== Adjust transmitter volume ==
+The output volume of the transmitter can be adjusted using the Transmitter Menu, Transmitter Config, Audio volume.
+==== Setting up the emulator for voice alerts ====
+Download and unzip the emulator package for your transmitter.
+  - Download the //\mp3// folder and files and place the //\mp3// folder in the same folder with the exe.  The //\mp3// folder is included in the voice alerts zip file from [[https://www.deviationtx.com/downloads-new/category/1010-moeder-voice-packs|Test Builds/[Moeder]voice_packs]] or in the voice packs created by [[https://moeder.pythonanywhere.com/voicepacker/default/index|Deviation Voicepacker]].
+  - Update the file system as you would update the TX file system:
+  * Make appropriate changes to the //hardware.ini//
+  * Copy the //voice.ini// to the //\media// folder
+  * Edit each //model.ini// to enable sounds or use the voice configuration menu (except devo7e, see above).

DeviationWiki

User Tools

Site Tools

Differences

Page Tools