Transcript
ABCL DEMO applications BCL is the BARIX Control Language, it is a simple (like Basic) but very powerful programing language to control Barix devices like the BARIX Barionet. In the meantime there is also a ABCL interpreter firmware (ABCL kit) existing for the Barix Audio products – the Annuncicom, the Instreamer, the Exstreamer and also for the IP Audio mudule. It runs on the older and newer product generation . ABCL gives you access to almost all interfaces of the BARIX devices. You can create your own applications which fulfill your special requirements. For ABCL development you need : -
a normal text editor, to create a BAS file with the ABCL commands Only in this BAS file (e.g. custom1.bas) you have write your ABCL commands !!
-
the file “tokenize.exe”, to convert the BAS file to the right format that the BARIX device can interpret the ABCL commands (creates a TOK file)
-
the file “web2cob.exe”, this adds all from your program needed files (e.g. html, tok or MP3) to a archive with a special file structure to store it into the BARIX device´s web server (creates a COB file)
On BARIX Audio devices you can use the “advanced Update” function to load the COB file to the web server. We have also prepared some DEMO applications, which can be used also as base for the your own application. The “tokenize.exe” and the “web2cob.exe” and also the source code for ABCL demo applications are available and mostly (exceptional the USB-FTP player) contained in the ABCL firmware kit which is available on the Barix homepage. All examples are working and can be used with the BARIX audio products ! Currently available are the following DEMO applications : -
Full-duplex application for Annuncicom / IPAM FTP-USB recorder application for Annuncicom / Instreamer / IPAM Audio Stacker application for Annuncicom / IPAM (multiple inputs to one output) Intercom Client (iclient) Intercom Master (imaster) SIP Client (for Annuncicom/IPAM or limited also for Instreamer and Exstreamer) FTP/HTTP store and forward MP3 player (for Exstreamer and IPAM)
-
USB-FTP player for Exstreamer / IPAM (older application, available on request)
On the following pages you will find a short overview about the above mentioned applications. All applications have also a online help which explains how to use it .
Full-duplex application for Annuncicom This application allows to use the Annuncicom in full-duplex mode, speaking and listening to another device at the same time with a minimum delay. The application is contained in ABCL firmware package . There you have a pull down menu where you can select the application. If the “Full-duplex Annuncicom” application is selected (and applied) then the “APPLICATION” button will bring you to the FULL DUPLEX INTERCOM menu (see screenshot) The application can be used for “point to point” communication. In a LAN environment you can also use a broadcast IP address, then it can be also used for “point to multi point” applications, but in this case only one device should answer (at the same time) . It supportes only G.711 or PCM codecs, it does not support MP3. Supported protocols are “RAW UDP” and “RTP” and because of RTP/G.711 it can be also used for communication to some other VoIP applications. The application can send the audio from line-in or the microphone input encoded to another IP address by using the UDP protocol. Following Streaming Modes are available : “Send always”, “send on I1” (PTT button) or “respond” (active during incoming stream) . “Respond” function includes also a “send to origin source” feature which allows to stream back to dynamic/variable IP addresses. When a audio stream is received then the relay will go on for the time of a incoming audio stream, this can be used e.g. to switch a notification light or to turn on any amplifier. It is also usable over a fast (DSL) internet connections.
Depending from the used Encoding settings you should the values from the table below for “Buffer” setting and “Transmit Packet Size” to get a proper communication ! By playing with this two values you can reach also lower latencies or better network performance ! Encoding uLaw /aLaw 8kHz (8bit G.711) uLaw /aLaw 24kHz (8bit G.711) PCM 8 kHz (16bit) PCM 24 kHz (16bit)
Buffer 800 2400 1600 4800
Transmit Packet Size 160 480 320 960
Bandwidth (in one direction) 64 kbit/s 192 kbit/s 128 kbit/s 348 kbit/s
FTP-USB recorder application for Annuncicom / Instreamer With this application the BARIX device can live record to a attached USB stick (Annuncicom100 or IPAM only) and / or to a FTP server. If you record to the USB stick then it can upload also the recorded files automatically and periodically to a FTP server. The recording format is MP3, the audio bitrate is selectable. The application is contained in ABCL firmware package (also as source). There you have a pull down menu where you can select the application. If the “FTP-USB Recorder” application is selected (and applied) then the “APPLICATION” button will bring you to the following FTP-USB RECORDER CONFIGURATION menu
The recording can be started/stoped per serial commands, UDP commands, web button or PTT button (Input0). The feature “Upload time” allows to make a periodically transfer to a FTP server if the files are recorded to the USB stick. Direct recording to the FTP server or to the USB stick only is also supported. Per default the created MP3 files will get a time stamp in the file name.
Audio Stacker application for Annuncicom Audio Stacker can join multiple audio inputs on multiple Barix Annuncicoms to one Annuncicom´s output without loss of audio and without playing two streams at the same time. If the input-device detects that the output-Annuncicom has already a incoming stream then it will save temporary the audio on his local USB stick and stream to the output-Annuncicom as soon this is not more busy. Audio formats are G.711 and PCM, MP3 is not supported. The application is also contained in ABCL firmware package (inclusive source code) . There you have a pull down menu where you can select the application. If the “Audio Stacker” application is selected (and applied) then the “APPLICATION” button will bring you to the following AUDIO STACKER menu .
Intercom Client This application allows together with the Intercom master a dynamic & standalone intercom system.
Intercom Master This application allows together with the Intercom client a dynamic & standalone intercom system.
SIP Client This application allows communication from and to (in full-duplex) a SIP server or also Peer to Peer to e.g. another Annuncicom . Features - supports peer to peer calls as well as calling into Asterisk or Cisco phone systems - one configurable destination number to call - automatic/manual call pickup - configurable syslog debugging - NAT keepalives - u-Law/A-Law 8kHz audio - door/relay open code - call on level To accept a call (manual pickup mode) press button 0 or button 1 on the Annuncicom, or connect PIO 23 or PIO 22 of the IPAM to ground. For remote door opening (from other hosts), set the secret code to be sent to trigger the relay and the timeout for the door.
FTP / HTTP store and forward MP3 player This application downloads playlists and MP3 files from a configured FTP/HTTP server to local USB drive and plays them according to the configured time schedule (in the playlist definable). Features background update of mp3 files and playlists. # Example player.cfg file # save this file on the USB storage into player/player.cfg # empty lines and lines starting with # (comments) are ignored #------------------------- CONFIGURATION SERVER ------------------# DNS or IP address of the server CONFIG_SERVER=10.0.0.102 # protocol: http or ftp (default) CONFIG_PROTOCOL=ftp # FTP/HTTP port (default 21) CONFIG_PORT=21 # FTP/HTTP username (default "anonymous") and password (default "a@a") CONFIG_USERNAME=anonymous CONFIG_PASSWORD=a@a # source directory on the FTP/HTTP server where the configuration resides CONFIG_DIR=/ # configuration update interval in seconds CONFIG_UPDATE=300 #---------------------- MEDIA SERVER --------------------------# DNS or IP address of the server MUSIC_SERVER=10.0.0.102 # protocol: http or ftp (default) MUSIC_PROTOCOL=ftp # FTP/HTTP port (default 21) MUSIC_PORT=21 # FTP/HTTP username (default "anonymous") and password (default "a@a") MUSIC_USERNAME=anonymous MUSIC_PASSWORD=a@a # source directory on the FTP/HTTP server where playlists and mp3 files reside MUSIC_DIR=/ # media files update interval in seconds MUSIC_UPDATE=600 #--------------------- NTP SERVER -------------------------------# DNS or IP address of the server NTP_SERVER=10.0.0.1 # time update interval in seconds NTP_UPDATE=3600 # positive or negative offset in hours from UTC # e.g. +1 for Central European Time, +2 for Central European Summer Time LOCALTIME=+2 #--------------------- MTELL SERVER-----------------------------# DNS or IP address of the server #MTELL_SERVER=www.m-tell.de # HTTP port of the MTELL server (default 80) #MTELL_PORT=80 #--------------------- PLAYLISTS -------------------------------# order of the playlists give their priority # the first playlist below has the highest priority PLAYLIST=evening.m3u PLAYLIST=morning.m3u
FTP-USB Player for Exstreamer This application can play a playlist from USB Stick. Also it can periodically or scheduled compare his current playlist on the USB stick with a playlist on the FTP server. If the playlist content is different then the Exstreamer will download the new playlist and songs in the background (in foreground it plays the currently playlist in a loop) to his USB stick. When the download of the new songs/playlist is finished then the Exstreamer plays this current song until end. Thereafter it deletes all not more required files from the USB stick and starts playing the songs of the new playlist . The application is not included in the ABCL kit and must requested separately from Barix. With the application comes then also the BCL source code .
The feature “Upload Time” is the timer for a periodically or scheduled check (automatically) with the playlist on the FTP server.
