Harald: 1 revision imported

2016-10-27T16:03:00Z

1 revision imported

Harald: /* Test Environments */

2010-03-11T12:05:43Z

‎Test Environments

New page

== Test Environments ==

{| class="smalldiv"
| style="background-color:#F6F9ED" |
| style="background-color:#F6F9ED" | Comments
| style="background-color:#F6F9ED" | '''Nut/OS 4.8.0'''
| style="background-color:#F6F9ED" | '''Nut/OS 4.9.9'''
|-
| Ethernut 3.0 E
|
| NO
| NT
|-
| Ethernut 3.1 D
| NutThreadYield added
| NT
| OK [http://ethernut.de/arc/WIKI_BINARIES_ZIPPED/read-phat-dir-ENUT31-nutos-4.9.9.zip '''Binaries''']
|-
| EIR 1.0 C
| Set jumper JP1 to DEBUG mode.
| OK [http://ethernut.de/arc/WIKI_BINARIES_ZIPPED/read-phat-dir-EIR1C-nutos-4.8.0.zip '''Binaries''']
| NT
|-
| AT91SAM7X-EK
|
| NT
| NT
|-
| AT91SAM9260-EK
|
| NT
| NT
|-
| id="compilertd" colspan="5" |'''Compiler:''' ARM-GCC 4.2.2 ; AVR-GCC 4.3.0
|}

== Source Code ==

<source lang="c">
#include <dev/board.h>
#include <fs/phatfs.h>
#include <dirent.h>
#include <stdio.h>
#include <io.h>
#include <fcntl.h>

int main (void)
{
uint32_t baud = 115200;
int hvol;
DIR *dir;
struct dirent *dent;
int cnt = 0;

NutRegisterDevice(&DEV_DEBUG, 0, 0);
freopen(DEV_DEBUG_NAME, "w", stdout);
_ioctl(_fileno(stdout), UART_SETSPEED, &baud);

NutRegisterDevice(&devPhat0, 0, 0);
NutRegisterDevice(&DEV_MMCARD, 0, 0);

printf("Mounting card...");
hvol = _open(DEV_MMCARD_NAME ":1/PHAT0", _O_RDWR | _O_BINARY);
if (hvol == -1) {
puts("failed");
} else {
puts("OK");
dir = opendir("PHAT0:/");
if(dir == NULL) {
puts("Cannot read root directory");
} else {
for (;;) {
dent = readdir(dir);
if (dent == NULL) {
break;
}
puts(dent->d_name);
cnt++;
}
closedir(dir);
}
_close(hvol);
}
printf("%d entries found\n", cnt);

for(;;);
return 0;
}
</source>

== Output ==

The program will list all entries in the root directory.

Mounting card...OK
test1.txt
test2.txt
2 entries found

== Details ==

All required header files must be included in the source.

<source lang="c">
#include <dev/board.h>
#include <fs/phatfs.h>
#include <dirent.h>
</source>

The first, [[Using dev/board.h|dev/board.h]], defines some platform independent defaults like DEV_MMCARD and DEV_MMCARD_NAME.

<code>fs/phatfs.h</code> contains definitions of the [[PHAT filesystem]], while <code>dirent.h</code> provides prototypes for reading directories.

As usual, we must register all drivers we want to use. For reading MMC cards, the MMC driver as well as the PHAT files system driver are required.

<source lang="c">
NutRegisterDevice(&devPhat0, 0, 0);
NutRegisterDevice(&DEV_MMCARD, 0, 0);
</source>

To access the card, it must be mounted first.

<source lang="c">
hvol = _open(DEV_MMCARD_NAME ":1/PHAT0", _O_RDWR | _O_BINARY);
</source>

<source lang="c">
dir = opendir("PHAT0:/");
</source>

<source lang="c">
dent = readdir(dir);
</source>

<source lang="c">
closedir(dir);
</source>

== Pitfalls ==

=== Interrupts not working ===

The simple demo presented here may not work with all Nut/OS versions and target boards. Mounting the card fails with error 19 (ENODEV).

When Nut/OS enters the main routine, all interrupts are disabled. They will become automatically enabled on the first context switch. On the other hand, the card detection is interrupt driven. As long as interrupts are disabled, no card detection is signaled and the MMC driver assumes, that no card has been inserted in the socket.

For example, when running on Ethernut 3, our demo will use polling drivers only (devDebug and devNplMmc0) and no context switch
takes place, which would enable the card detect interrupt. A simple call

<source lang="c">
NutThreadYield();
</source>

will solve this by forcing a context switch. Add this line before mounting the file system with _open(). Note, that you additionally need to include the header file sys/thread.h.

Alternatively you can use

<source lang="c">
sei();
</source>

for the AVR or

<source lang="c">
asm volatile("mrs r12, cpsr\n"
"bic r12, r12, #0xC0\n"
"msr cpsr_c, r12");
</source>

for the ARM to enable interrupts.

== See also ==
* [[Reading PHAT Files]]
* [[Writing PHAT Files]]
* [[MMC MP3 Player]]
* More [[Nut/OS Examples]]

== External Links ==

[http://en.wikipedia.org/wiki/Dirent.h dirent.h] Posix standard header for directory traversing.

← Older revision	Revision as of 16:03, 27 October 2016
(No difference)

Reading PHAT Directories - Revision history

Harald: 1 revision imported

Harald: /* Test Environments */