Amr-100 Help - Table of Contents

Introduction *
Installation
System Info menu *
Output formats
Cartchunk options
Lots more
Destination Directory
Renaming files
Playlist editor *
Files/Transfers *

* New or changed
features

Tools Menu *
Support menu *
FTP Transfers *
Help menu *
Status indicators
Refresh
Enable misc transfers
Transfer queue
Timed transfers
Activity log
Program updates
*
Miscellaneous topics
Automatic sysinfo backup
Offsite backup
Daylight saving time
Manually transfer files
Normalize audio levels
Temp file cleanup
Ebno reporting
System errors
XDS file tranfers
Scott SS32 scot-chunk
Amb-OS RSS feed
Program Name Changes
Custom programs *

Rev 5/22/2018 for 1.31.40


Introduction

The Amb-os User Interface is the interface to the Amb-os AMR-100 satellite receiver. It will transfer files from the receiver to your local disk(s), and maintain playlists for playing audio out of the receiver.

More information is available at www.amb-os.com. Telephone support is available at 1-877-AMBOS2U (1-877-262-6728). There is also a manual available in pdf format.

The Amb-os system delivers audio files to the receivers instead of "real-time" audio. The files are stored on the AMR-100's own hard disk, to be available to you when you need them. The receiver can also play them through its 2 stereo (or 4 mono) output ports. This gives you a great deal of versatility. Just some of the ways the receiver can be used are:

Play on air - The receiver can play files on its audio outputs directly to your main board according to your own schedule. Relays can be set to pulse or close and open when the file is playing. This is done by setting up a playlist with the Playlist editor. There is the potential for the receiver to handle all of your on-air needs for airing recorded programs. There are also trigger (relay) inputs to the receiver to synchronize the recorded audio with local or live audio.

File transfer - The user interface program can transfer files from the AMR-100's hard disk directly to your local disk, either when they become available, or according to your own schedule. The Rename files page allows you to rename the files to your own local naming convention, and to control when they will be transferred. For example, your automation system may be set up to play the same file every weekday, eg TheDaily.mp2. You can schedule this file to be over-written at a specific time each day, so each day you will be airing the current day's program. This would be similar to recording over a file every day from the former satellite feed. Only it happens when you want it to.

Play to record - You could also set up times for the receiver to play audio to be recorded by your automation system. It would be very much like recording a satellite feed, except you would control the "feed times" using the Playlist editor and would not be bound to the former satellite schedules.


Main window features

Destination Directory

You must choose a destination folder on your computer (or on a network drive) for saving the files to be transferred from the receiver.

As you enter file renaming info on the Rename files page, you can enter paths relative to this folder.


Files/Transfers

This will list the files currently on the receiver, along with their transfer status, runtime and their local name according to the renames you have set up. Runtimes are calculated to msec.

Status may be:

At the top of the page, you can select a status to show (All, Ok, Misc, Old, Timed, Errors). You can double-click on a file to manually transfer it (not available for all statuses). You can also single-click a file and the Save as button becomes active and you can save a file as-is (no conversion, etc).

Custom pgms will be transfered including the station's custom liner/tag.

Multi-part pgms do not 'combine' when transfered here. Just each part transfers.

Of particular interest are the Misc transfers

These are files on the receiver for which a timed transfer has not been set on the Rename files page. It will also list files that are more than 24 hours past their transfer time. (Less than 24 hours, and they will be transferred as "LATE".)

These files will all be transferred if the Enable misc transfers box is checked. Note that if files are in the misc folder when the Enable box is checked, they will immediately be put in the transfer queue. In earlier versions, they would be transferred one at a time and you could stop their transfers at any time by un-checking the enable button. Now they are queued right away, and once in the queue, they are transferred in the processing of the queue.


Amb-OS Support functions (Support menu)

These should be used when only directed by the Amb-OS support team. Each one uploads a specified UI file to the receiver where it can be grabbed by the team, or emails a file to support.


Help

The Help menu contains: The help file is stored on your computer's disk, so you can access it at any time. The receiver manual and receiver's web page are also local to your network. The other links are on the web, so the UI's computer would need internet access to reach them.


System error

If the UI encounters a Windows system error, a button will appear next to the Exit button. Pressing it will open a window that will list the official text explanation of the error. This is the same window opened by the Help menu 'Look up an error number' except the number is entered for you. Once pressed, this button will disappear -- until the next error comes along.


Refresh

The Refresh button is a cute little button that you will likely never use, unless you get very bored one day. Refresh reads the files on the receiver, compares it to the files on your local disk, and sees what files should be transferred. It also checks any timed transfers that you set up on the Rename page and sets timers for each one.

The reason you don't need this button (except to escape bordom) is that the system automatically refreshes when the program is started, when a file is received from the satellite, and every 10 minutes.

Speaking of 10-minute refreshes, you will see Next refresh on the main window followed by a time. That would indeed be the time of the next 10-minute refresh.

Below that, just above the activity window, you'll also see a time which is updated every minute from the receiver.

Note that this is just the a "delta" refresh that looks for new files on the receiver. If you should need to start from scratch and totally rebuild the files list, see Total refresh in the Tools menu.


Enable misc transfers

This checkbox enables miscellaneous transfers -- those not having transfer times set in the Rename files screen.

This setting will be saved when the UI is stopped, so when you start the UI up again, it will be set the same as it was before.

This has no effect on the Timed transfers, which happen all on their own.


Transfer queue / Queue editing

This window shows the pgms queued for transfer from the receiver, or being converted (to wav, etc).

An 'Edit queue' button has been added above the Transfer queue window. If something went wrong overnight and now you have a lot of files in the queue and you need to prioritize them, this button will pause the queue and let you move them to the top of the list by double-clicking each one. Also, when the UI starts up, any files in the queue are sorted starting with the current date. That should also help if something causes a backlog. If a file is being transfered, it will continue (so the 'top' of the queue will be just below that file that's being transfered). A 30-second timer is set and when it times out, the queue will re-start. We wouldn't want the queue to be stopped indefinitely. And each time you double-click an entry to move it to the top, the timer starts again at 30 seconds. Another button will appear to allow you to re-start the queue without waiting for the 30-second timer.

If you want to try this out, open the Files/Transfers menu and double-click some files to put them in the queue. Then pause it and move them around.


Timed transfers

This window lists the dates and times (based on your local computer's time) when timed transfers of files from the receiver will occur. The next transfer is at the top of the list.

The list can change at any refresh. If a new file has been received by the receiver that is subject to a timed transfer, it will be added to the list, perhaps even at the top of the list. The transfers are not enabled until the file to be transferred is on the receiver.

Timed transfers are set up on the Rename files page. This enables you to control the time that a local file will be over-written by a newer file. Eg, if you use a filename like focusdaily.mp2 for your automation system, and need it to be over-written each day with the new day's program, you would want to set up a transfer time for that file. For more information, see the Rename files page.

Files that arrive late (less than 24 hours after their transfer time) will be transferred as soon as they arrive. Also, if a file gets replaced by a newer file the newer file will be transferred. These will be logged as LATE or REPL in the activity log.

Timed transfers are affected by changes in daylight saving time. Timed transfers are scheduled using Windows system timers, which operate like kitchen timers. You set them for a certain amount of time, and then they "ding". For each file to be transfered, a timer is set when the file arrives on the receiver, so if a daylight saving time change occurs before the ding, it will be at the wrong (old) time. So the UI checks for timezone changes during its periodic refresh and, twice a year, adjusts the timers so they will ding at the right time according to the new time.


Activity log

The Activity log window shows receiver and transfer activity. The most recent entry will be at the top of the list. The time and event will be shown. The activity is also be logged to a monthly file (see Explore log files in the Tools menu). Events include: Starting with 015m, if a program producer replaces a program and re-sends it over the satellite after it has been transferred into your system, it will be re-transferred if:


Offsite backups

This feature uploads some information files to Ambassador's FTP site for safe-keeping in case of computer and/or receiver melt-down. Files saved include your export.txt and playlist.txt files, to help rebuild your system in case local copies get munged by a hard disk failure. This offsite backup is done whenever a UI is started, and weekly after that. The files are saved according to the receiver serial number and the name of the computer the UI is running on, so if multiple UIs (on different computers) are working with the same receiver, they will each have their own offsite backup. Yes, munged is a highly technical term describing the re-arranging of data bytes and bits into an unusable state.

NOTE: If the UI computer does not have internet (outside) access, you should check the Do not backup to FTP box in the System info menu.

The date and time of the next offsite backup is shown under the time of the next refresh, under the Exit button.

An offsite backup can also be done manually in the Support menu.


Ebno reporting

A current Ebno reading and the max-min spread for the previous 24 hours is displayed on the right side of the main window. It is updated hourly, and is based on the receiver's log15.html page.

See also the Ebno status indicator


Program updates

NEW
Updating the amb-xfer.exe executable is not as easy as it once was. Automatic updates are next to impossible in newer versions of Windows, and updater/installer files that seek to do so are seen as a virus. So the updates are now sent as official NSIS installer files, which is a blessing in that it handles all the new dll files needed for transfering files as wav and using SFTP.

There are two degrees of updates. Optional updates are found in the Help menu. UI updates lists updates on your receiver for you to pick from. This list includes brief descriptions of the changes made in each rev. UI installs on the web links you to the UI beta web page where the same installs are found.

Required Updates, when sent out, cause a 'nag screen' to appear from time to time. Please do the update as soon as practical, or advise us if the update is impossible and we'll kill the nag.

The UI beta web page is www.amb-os.com/ui