Atmel AT89C51SND1C User manual

Firmware Package
.............................................................................................
User Guide

Firmware Package User Guide 1
4209A–MP3–12/02
Section 1
Introduction...........................................................................................1-1
1.1 Doc Control...............................................................................................1-1
1.2 References................................................................................................1-1
1.3 Abbreviations ............................................................................................1-1
Section 2
Installation.............................................................................................2-3
2.1 Architecture...............................................................................................2-3
2.2 Firmware Configuration.............................................................................2-8
2.3 SBC Libraries Interface.............................................................................2-9
2.4 Mass Storage Drivers..............................................................................2-10
Section 3
Operating Description.........................................................................3-11
3.1 Keypad Assignment................................................................................3-11
3.2 Firmware Upgrade ..................................................................................3-11
3.3 Start-Up...................................................................................................3-11
3.4 Mode Selection .......................................................................................3-12
3.5 Song Operating Mode.............................................................................3-12
3.6 Voice Operating Mode ............................................................................3-15
3.7 Tool Operating Mode ..............................................................................3-17
3.8 Download Operating Mode .....................................................................3-18

Firmware Package User Guide 1-1
Rev. 4209A–MP3–12/02
Section 1
Introduction
The AT89C51SND1C demonstration firmware is part of the AT8xC51SND1C starter kit.
This document is the user’s manual of the AT89C51SND1C demonstration firmware. It
is based on the development board V2.1 or V2.2.
1.1 Doc Control
1.2 References nAT8xC51SND1C Datasheet
nAT89C51SND1C Errata Sheet
nAT8xC51SND1 Development Board User’s Manual
1.3 Abbreviations nMP3: MPEG layer 3
nMMC: MultiMediaCard
nDF: Atmel on-board DataFlash memories
nUSB: Universal Serial Bus
nFAT: File Allocation Table
nSBC: SCSI Block Command
Rev Pages Purpose of Modifications Author Date
AAll
Document creation based on V1.2.x user’s
manual. Support for AT89C51SND1C. Fosse. F Oct. 22, 2002

Installation
Firmware Package User Guide 2-3
4209A–MP3–12/02
Section 2
Installation
The firmware package is delivered in a zip file: snd1-demof-2_0_x.zip that extracts in an
Atmel\at89c51snd1c directory.
2.1 Architecture
2.1.1 Overview Figure 2-1 shows the organization of the Atmel\t89c51snd1 directory. The follwoing sec-
tions detail the content of the sub-directories.
Figure 2-1. Atmel\at89c51snd1c Directory Organization
2.1.2 usb_ms_drv
Directory As shown in Figure 2-2, the win_drv directory contains the windows 98™driver for the
USB mass storage application. The ‘readme’files gives some advice on how to instal
drivers on windows 98™platform and how to mount the removable disk on Linux™
platform.
Figure 2-2. usb_ms_drv Directory Organization
lib\
lib_demob\
lib_mem\
Atmel\at89c51snd1c\
demo\
usb_ms_drv\
lib_storage\
usb_ms_drv\ atusbms.zip
readme.txt
readme_linux.pdf

Installation
2-4 Firmware Package User Guide
4209A–MP3–12/02
2.1.3 lib Directory As shown in Figure 2-3, the lib directory is organized in sub-directories that contain the
low-level drivers of the AT89C51SND1C peripherals.
The lib directory also contains the following files:
nc51_drv.h: this header file contains macro functions able to configure c51 core
features such as clock mode, ERAM size, global interrupt…
ncompiler.h: this header file contains new type definitions, general purpose constants
and macro functions able to get rid of compiler type.
nregsnd1.h: this header file contains special function registers and bit definition of the
AT8xC51SND1C products.
nextsnd1.h: this header file contains mask definitions for special function registers of
the AT8xC51SND1C products.
Figure 2-3. lib Directory Organization
adc\
pll\
adc_drv.c
adc_drv.h
aud\ aud_drv.c
aud_drv.h
pll_drv.h
kbd\ kbd_drv.c
kbd_drv.h
mmc\ mmc_drv.c
mmc_drv.h
mp3\ mp3_drv.c
mp3_drv.h
spi\ spi_drv.c
spi_drv.h
timer\ timer_drv.c
timer_drv.h
usb\ usb_drv.c
usb_drv.h
c51_drv.h
compiler.h
regsnd1.h
extsnd1.h
wdt\ wdt_drv.h
lib\
clock\ clock.c
clock.h

Installation
Firmware Package User Guide 2-5
4209A–MP3–12/02
2.1.4 lib_demob Directory As shown in Figure 2-4, the lib_demob directory is organized in sub-directories that con-
tain the low-level drivers of the AT8xC51SND1C development board peripherals.
The lib_demob directory also contains the following file:
ndemob.h: this header file contains definitions of the board hardware such as LCD
address, On-board Flash chip select ports…
Figure 2-4. lib_demob Directory Organization
2.1.5 lib_mem Directory As shown in Figure 2-5, the lib_mem directory is organized in sub-directories that con-
tain the high-level drivers of memories or cards that can be connected to the
AT8xC51SND1C products.
Figure 2-5. lib_mem Directory Organization
2.1.6 lib_storage
Directory As shown in Figure 2-6, the lib_storage directory contains the libraries for SBC mass storage support. In order to standardize the interfaces and to keep confidentiality on
these modules embedded SCSI modules are delivered in library form (source code not
delivered).
SBC module is composed of the following libraries:
nsbc.lib
This lib contains the common (not memory dependant) SBC functions.
nsbc_df.lib
This lib contains the specific SBC functions for DataFlash support.
nsbc_mmc.lib
This lib contains the specific SBC functions for MultiMediaCard support.
nsbc_nf.lib
This lib contains the specific SBC functions for Nand Flash support.
nsbc_smc.lib
This lib contains the specific SBC functions for SmartMediaCard support.
nsbc_cf.lib
This lib contains the specific SBC functions for CompactFlash support.
Information on how to interface with those libraries is given in Section 2.3.
dac\
demob.h
lib_demob\ dac_drv.h
lcd\ lcd_drv.c
lcd_drv.h
df\
nf\
lib_mem\ df.c
mmc\ mmc.c
mmc.h
df.h
nf.c
nf.h
nf_drv.c
nf_drv.h
nf_drv.a51
xxx\

Installation
2-6 Firmware Package User Guide
4209A–MP3–12/02
Figure 2-6. lib_storage Directory Organization
2.1.7 demo Directory The demo directory contains all the demonstration firmware core directories. These
directories contain some important companion files giving information on the demon-
stration firmware. Please read this files carefully.
Figure 2-7. demo Directory Organization
2.1.7.1 demo_fat\doc
Directory The demo\demo_fat\doc directory contains the user’s manual of the firmware in PDF format.
2.1.7.2 demo_fat\bin
Directory The demo\demo_fat\bin directory contains the Keil™µ-vision2 project files, and the exe-
cutable file in Intel™“.hex”format. Depending on the demo, up to three “.hex”files can
be found under this directory:
nplayer.hex: compilation result of the current configuration.
nsnd1c-demo-df-b21-2_0_x.hex: V2.0.X firmware for the V2.1 board.
nsnd1c-demo-df-b22-2_0_x.hex: V2.0.X firmware for the V2.2 board.
2.1.7.3 demo_fat\obj
Directory The demo\demo_fat\obj directory contains the object files of all modules after compilation.
2.1.7.4 demo_fat\src
Directory As shown in Figure 2-8, the demo\demo_fat\src directory is organized in sub-directories that contain files such as system header and source files, task header and source file.
sbc.h
sbc_mmc.lib
lib_storage\
sbc_df.lib
sbc_nf.lib
sbc_smc.lib
sbc_xxx.lib
sbc.lib
demo\ demo_fat\ bin\
obj\
src\
tst\
doc\
demo_nf\
CHANGES.txt
INSTALL.txt
LICENSE.txt
NEWS.txt
README.txt
…
doc\

Installation
Firmware Package User Guide 2-7
4209A–MP3–12/02
Figure 2-8. demo\demo_fat\src Directory Organization
clock\
file\
demo\demo_fat\src\ clock.c
clock.h
display\ disp.c
disp.h
fat.c
kbd\ kbd_task.c
kbd_task.h
mass\ usb_task.c
mem\ hard.h
mem_task.c
mode\ mode_task.c
mode_task.h
song\ song_drv.c
song_drv.h
system\ config.h
main.c
voice\ voice_drv.c
voice_drv.h
fat.h
disp_task.c
disp_task.h
file.c
file.h
mem_task.h
song_task.c
song_task.h
scheduler.c
scheduler.h
startup.a51
variable.c
voice_task.c
voice_task.h
tool\ tool_task.c
tool_task.h
usb_task.h
sbc.h
sbc.lib
sbc_df.lib
sbc_mmc.lib

Installation
2-8 Firmware Package User Guide
4209A–MP3–12/02
2.2 Firmware
Configuration There are two files that are used to configure the firmware:
nthe “config.h”located under the demo\demo_fat\src\system\ directory used to
configure the library/drivers as detailed in each driver header files.
nthe “board.h”located under lib_demob\ directory used to configure the board type
between V2.1 or V2.2 and the component information of the board.
Note: When working with the starter kit, only the board type has to be configured,
component configuration must not be changed.
2.2.1 USB IDs Three IDs are available for configuration by the user in config.h file:
nVendor ID
nProduct ID
nRelease Number ID
According to USB Organization: “Vendor ID (VID) is owned by the vendor company and
is assigned and maintained by the USB-IF only. E-mail [e-mail] for more infor-
mation on USB-IF membership and obtaining a VID”.
Atmel allows usage of its VID (03EBh) during product development phase. In any case
Atmel’s VID may be used by customer for market release. Deviation to this rule may
lead to host USB crash in case of IDs confusion.
2.2.2 USB Mass Storage
Strings Six strings are available for configuration by user in config.h file. those strings are printed during USB drivers installation and during disk drivers status report in host
system:
nUSB_MANUFACTURER_NAMEunicode character string
nUSB_MN_LENGTHnumber of unicode character
nUSB_PRODUCT_NAMEat least 12 unicode characters string
nUSB_PN_LENGTHnumber of unicode characters
nUSB_SERIAL_NUMBERat least 12 unicode characters string
nUSB_SN_LENGTHnumber of unicode character
nSBC_VENDOR_ID8 ASCII characters string
nSBC_PRODUCT_ID16 ASCII characters string
nSBC_REVISION_ID4 ASCII characters string