Home > DTBM Firmware

NLS: That All May Read

NLS DTBM Firmware

The NLS Materials Development Division (MDD) modifies the DTBM software from time to time to correct faults, improve usability, or to add additional features.

The latest player firmware is version 2.1.2 (October 6, 2009) http://www.loc.gov/nls/DTBM/DTBMsoftware-2.1.2.zip

Libraries and patrons can upgrade players to the latest software in the following manner:

  1. Obtain the latest software from the NLS web site:
    http://www.loc.gov/nls/DTBM/DTBMsoftware-latest.zip
  2. Extract (unzip) this file onto a cartridge or USB drive so that the directory “upgrade” appears in the “root” directory of the drive.
  3. Turn on the player.
  4. Insert the cartridge or USB drive containing the software.
  5. The player will announce “Upgrading your player’s software.”
  6. Wait until the upgrade is complete and the player restarts (about 10 seconds), then remove the cartridge.
  7. The upgrade will only occur if the player’s version is older than the version of the software on the cartridge; reinserting the cartridge will not repeat the upgrade.
  8. The table below describes the major changes made in each revision.

DTBM Software Version History (August 31st 2009)

Version

Changes/Enhancements

1.1.76

  1. Don't announce “player on” if recovering from watchdog (warm reset)
  2. Don't beep if recovering from watchdog (warm reset)
  3. If removal of cartridge is detected, then wait for end of the snap point initialization, so that position can be saved without a “seg. fault” restart
  4. Flag Z39.86 initialization that does not complete (so we don't try and change position based on bogus data)
  5. Cause persistent full keyboard buffer to initiate a watchdog event.
  6. Allow power off in “Service 3” (when entered via options.xml)

1.1.77

  1. Correct setting of tone (when recalling from profile)

2.0.0

  1. If audio file is in stereo, preserve channel separation if headphones are used. (do not mix to mono)
  2. First production release

2.0.1

  1. Recurse into directory structure to add to book chain for NISO, DAISY and CEA books
  2. Ignore all “dot” directories (not just . and ..) when looking for books (Apple & Unix hidden directory practice)
  3. Correct spelling of “ingles” in “options.xml”
  4. Added some error checking to prevent “segmentation fault” restarts with some CNIB DAISY books.
  5. Add checking to various routines during NISO initialization to abort if cartridge removed. When processing a large NCX (e.g. Joy of Cooking), many seconds can be spent processing the NCX and the program attempts to access files that cannot be found if the cartridge is removed.
  6. Separate time for “prev” to jump over datum for normal navigation (5 sec) and SMIL navigation (2.5 s) so that we have less tendency to jump over items when jumping back by SMIL segment in play mode. (short ingredient lists for example)
  7. Do not terminate other messages when playing “End of book” so that title will play to completion (if already at end when cartridge inserted).
  8. Do not play forward time (Forward 20 seconds) on multiple FF presses when at End of Book.
  9. Add a small pause (3000ms) before NISO_PlayAll when playing Title to avoid playing 50ms segment of book before title in some circumstances (when large NCX is processed).
  10. Give “beep/bop” response to returning to “current position” when in bookmark navigation. (Same response as other navigation levels)
  11. Make MP3 and CEA Information (Info button response) consistent with NISO & Daisy (Position/Time/Book/Power)

2.0.2

  1. Various corrections to battery recharge algorithm.
  2. Correct formatting for Voltage display in Service level 3. (did not give correct value for less than 1.0V)
  3. Report accumulated faults in Service Level 3 “b hw” command. (if one or more faults)
  4. Change the delay before book play (after title started) to 300ms.

2.0.3

  1. Correction to battery recharge algorithm.

2.1.0

  1. Implement “bookshelf” mode when multiple books are found on a UFD.
    (Press and hold "Play/Stop" to enter bookshelf and RW/FF to select book.)
  2. Reset “charge inhibit” flag when clearing power & status error in level 1 and 2 service modes. (so that the player will attempt to charge (without having to reset battery statistics))

2.1.0

  1. Correct book mark behavior (adding book marks on bookmark level just after beginning of book (in play))
  2. Do not announce current section heading when navigating by book mark (just time) (it was far too verbose and confusing)
  3. Add error checking during initialization to prevent “seg-fault” restart.
  4.  Accept loose audio files if in “Audio+Podcasts” directory if other books present
  5. Only announce 'book error' if a cartridge is still inserted
  6. Check for removal of cartridge during cartridge initialization to abort processing if user removes cartridge just after insertion.
  7. Stop playing messages prior to announcing “User Key Not Processed” (when processing KXO)
  8. Add <noUSBsuspend/> option to directives in option.xml so that troublesome USB drives may be used (albeit with higher battery drain)
  9. Move the CEA “book found” notice to after we've found the book!
  10. Suppress key describer when processing cartridges (accumulating books onto the chain)
  11. Add feature:
    Press and hold bookmark to move to bookmark navigation level and announce the number of bookmarks in the book
  12. Change Sleep behavior so that first press will announce number of minutes remaining and subsequent steps will increase sleep time (quantized to 15 min intervals)
  13. Announce “Sleep Cancel” when stopping player with sleep active.
  14. Cancel sleep (and announce sleep cancel) when cartridge removed
  15. Re-vamp the undo action at bookmark level to make it logical and consistent (and functional!)
  16. Correct CEA play segment (incorrectly calculated end time of short segments..  meaning they never finished)
  17. Correct Daisy (D2_PlayAllTask) so that playing of segments (in stop and segment mode) did not update the current pointer. (This caused playing of snippet of book in stop mode to move the read pointer).
  18. Recognize “NLS-Shared Master” as an NLS book (don't announce title when at beginning of book and don't engage AGC)
  19. Add “beep” at end of Daisy 2 segment play.
  20. Restore navigation level or phrase / bookmark (previously would set to lowest hierarchical level if on phrase or bookmark level.
  21. Check for cartridge removal in processing of the “authorization object” and in parsing html (to prevent “seg-fault” restart if user removes cartridge when processing book)
  22. In DAISY 2, do not reset the read position to the beginning of the SMIL segment after playing title.
  23. Handle the play/stop after pressing the Info button to play the book if Info message had stopped.
  24. Give a message for, but do not “eject” the disc (enter key describer) when finding a text only NISO book (e.g. Bookshare).
  25. Create a dummy interface to handle parking the UI when text only book found.
  26. Correct “level jump” announced to actual level for coarser navigation levels than that at the current reading position. (It was the most dominant at that level)
  27. Changed the routine to determine the dominant resource at a level to count those not in the resource list. (previously if the class was not found in the internal resource it was ignored (although it may have been dominant class))
  28. Announce page number using “text” number if audio is not present
  29. Ignore various Microsoft recycle bin directories and Apple “__macosx” directories when looking for books (in addition to upgrade, ‘.’ And ‘..”)
2.1.1
  1. Tone, Speed adjustment messages ("Tone Up", "Speed Up" etc) are rendered with the tone adjsutment applied (not at neutral tone)
  2. Correct issue that caused the player not to enter the User Guide if a book was being initiated when the User Guide was loaded.
  3. Correct issue that caused a reboot occasionally if a cartridge was removed while was being accessed.



NLS Home    ---    Library of Congress Home
Comments about NLS to nls@loc.gov
About this site    ---    Comments about this site to nlswebmaster@loc.gov
Updated August 31, 2009