Quelltext der Seite Mini2440

'''Der Artikel befindet sich erst am Anfang, wird aber die nächsten Tage über ständig erweitert. Wer was dazu zu sagen hat, kann das gerne auf der Diskussionsseite tun.'''

[[Bild:mini2440.jpg|300px]]

[http://www.friendlyarm.net/products/mini2440 Mini2440 von friendlyarm ]

Das [[Mini2440]] ist ein [[ARM]]-Board mit [http://www.samsung.com/global/business/semiconductor/productInfo.do?fmly_id=229&partnum=S3C2440&ppmi=PartnoSearch s3c2440] '''S'''ystem '''o'''n '''C'''hip von Samsung.

Das '''Board''' bietet:
* 3,5", 7" Touchscreen-[[TFT]] oder [[VGA]] "Karte"
* ARM920T, 400Mhz standard Taktfrequenz, bis zu 533Mhz
* 64MB-1GB NAND Flash (User App/OS), 2MB NOR Flash (BIOS)
* 64MB RAM
* Audio (Stereo Out, 2xMono In)
* SD-Slot
* [[USB]] Host, USB Device
* 10/100MBit LAN (DM9000)
* 3 Serial Ports
* [[SPI]], [[PWM]], [[I2C]], ...
* ...

Der '''Autor''' bietet:

hier '''keine''' Schritt-Für-Schritt Anleitung für alle Möglichkeiten!
Eher ein "Kurz-Guide" zu den wichtigsten Themen.
Ebenfalls gibt es hier auch ein paar Beispiel-Quellcodes.

== Software ==

Als das passende Entwicklungswerkzeug ist ein Linux-Rechner mit passendem Cross-Compiler sowie ein paar Tools vorgesehen.
Was wirklich benötigt wird:
* Serial Terminal (picocom, minicom, cutecom, gtkterm, komport, ...)
* lrzsz
* [http://www.mikrocontroller.net/articles/Mini2440#Toolchain Toolchain]
* s3c_boot_usb

Empfehlenswert ausserdem noch:
* ncurses-dev-Dateien und dialog (Für Kernel-menuconfig)
* screen, midnight commander, 

=== Vorbereitungen am/mit dem Board ===

Ganz wichtig ist es, eine gute Spannungsversorgung zu verwenden. Es kam anscheinend schon öfter vor, dass kleine Spannungseinbrüche das Board aus dem Gleichgewicht bringen.
Ich verwende normalerweise das mitgelieferte Netzteil oder ein '''5V'''/'''2A''' Schaltnetzteil, funktionieren beide einwandfrei.
Gerade das grosse, 7", Display braucht ein starkes, gutes Netzteil.

{| class="wikitable"
|+ '''ungefährer Stromverbrauch'''
|-
! Board konfig. || Stromverbrauch
|-
| mini2440  || mA
|-
| mini2440 + 3,5" TFT || mA
|-
| mini2440 + 7" TFT || mA
|-
| mini2440 + VGA Board || mA
|}


==== Verbindung zum PC ====

Um vernünftig arbeiten zu können, braucht es auf jeden Fall ein USB A<->USB B-Kabel, sowie ein 1:1 verbundes 9 poliges SUB-D Kabel mit zwei Buchsen.
Jenachdem, auf welchem Gerät "entwickelt" wird, braucht man noch einen USB-RS232 Adapter.

==== Netzwerk ====
Entweder klickt man sich quer durch die chinesische/japanische Software und stellt diese auf Englisch um, oder aber man klickt sich blind zu der Stelle, an der man IP Adresse, Gateway und Netzmaske angeben kann.

Etwa genauso "schwierig" sieht es über die Konsole aus.

==== Benutzeraccounts ====

=== Übertragen von Daten/Programmen ins Flash ===

Das übertragen gestaltet sich auf ganz unterschiedliche Weise.
==== Allgemein ====
Wenn man eine Datei übertragen hat, muss man sich vergewissern, dass diese auch Ausführrechte besitzt, wenn sie ein Programm oder ein Ordner ist. Die Lese- und Schreibrechte müssen ebenfalls richtig gesetzt sein.
Normalerweise stimmt dies alles so wie es ist, aber manchmal muss man ein wenig nachhelfen.
Wenn sich ein Programm nicht ausführen lässt, oder man nicht in einen Ordner wechseln kann, fehlen die Rechte zum Ausführen. Geändert wird das so:
<pre> $ chmod +x <datei/ordner></pre>
Da hier aber nicht die Unix-Rechte erklärt werden sollen, verweise ich [http://linuxwiki.de/DateiRechte hierauf]

==== lrzsz (seriell) ====
==== http ====
Für diese Methode muss natürlich das Netzwerk eingerichtet sein. Man braucht auf einem PC im Netz einen laufenden Werbserver, auf den man die zu übertragenden Dateien legt.
Nun kann man diese in ein Verzeichnis seiner Wahl "herunterladen":
<pre> $ cd /tmp
 $ wget http://10.2.5.29//datei
</pre>
==== ftp ====
==== scp/ssh ====
==== usb ====
==== [[JTAG]] ====

=== Toolchain ===
Toolchains gibt es im Netz und auf der CD/DVD zum Board mehrere fertig übersetzte, natürlich lässt sich die Toolchain auch selbst compilieren.

Jenachdem, welche Toolchain man einsetzt, kann es sein, dass man den Compileraufruf anpassen muss.
Wenn man eine Cross Toolchain installiert hat und nur ''gcc'' auf der Kommandozeile eintippt, wird man höchstwahrscheinlich beim ''lokalen'' gcc, keinem Cross-Compiler, landen. Überprüfen kann man das mit
<pre> $ which gcc</pre>
Die FriendlyARM Toolchain macht es uns da sehr leicht, sie verwendet aussagekräftige Namen für ihre Programme. Bei ihr wäre der gcc Aufruf der:
<pre> $ arm-linux-gcc
oder
 $ arm-none-linux-gnueabi-gcc
</pre>
Ich gehe im kompletten Artikel davon aus, dass man eine funktionierende Toolchain installiert hat, welche über ''arm-linux-...'' zu erreichen ist. Entweder passt man die gcc-Aufrufe von hier an, oder man kann sich auch [http://wiki.unixboard.de/index.php/ManPage:ln symbolische Links] anlegen.
Zum Schluss sollte das dann ungefähr so aussehen, vom bin-Pfad der Toolchain aus!
<pre> $ ls -al /usr/local/arm/4.3.2/bin/
 ...
 lrwxrwxrwx 1 root root      25 2010-02-25 07:15 arm-linux-ld -> arm-none-linux-gnueabi-ld
 ...
</pre>
Ich selbst arbeite mit der FriendlyARM-Toolchain, werde mich hier also meistens auf diese beziehen, ausser anders vermerkt.
==== FriendlyARM ====
[http://www.friendlyarm.net/downloads Hier] als ''ARM-Linux-GCC'' zu finden.

Entpackt verbraucht diese Toolchain ca. 295MB. Mit ihr liessen sich bei mir bereits der Kernel, uboot, sowie zahlreiche Programme kompilieren.

Zuerst wird die Toolchain an die richtige Stelle entpackt, der Pfad mit angegeben und dann ist sie auch schon bereit.
Dieses Kommando sieht auf den ersten Blick etwas nach Dateisystem-Apokalypse aus, ist allerdings lage nicht so wild. Die Option ''-C /'' sagt, dass direkt ins Wurzelverzeichnis entpackt werden soll, daher benötigt man für diesen Schritt '''root-Rechte'''. Die FriendlyARM-Toolchain ist so aufgebaut, dass sie damit nach ''/usr/local/arm/4.3.2/'' entpackt wird, '''unser Ziel''' :)
<pre> $ tar xvfj arm-linux-gcc-4.3.2.tar.gz -C /
</pre>
Wenn wir das nun so haben, müssen wir natürlich auch noch sagen, wo er den Compiler findet.
Dazu öffnet man am besten seine "autorun-Datei" der Shell. In der Konsole ganz einfach mit vim/nano/etc zu erreichen.
<pre> $ vim /home/user/.bashrc</pre>
Dort tragen wir dann '''ganz ans Ende''' dies ein:
<pre>export PATH=$PATH:/usr/local/arm/4.3.2/bin</pre>
Kaum gespeichert, startet man eine neue shell (Konsole) und überprüft ob die Pfade stimmen.
Wenn ''/usr/local/arm/...'' im Pfad enthalten ist, müsste alles stimmen.
<pre> $ echo $PATH</pre>
Tippt man nun '''nur''' ''arm-'' und drückt zweimal die Tabtaste, so müsste eine ellenlange Liste mit Programmen wie z.B. ''arm-linux-gcc'' oder ''arm-linux-ld'' erscheinen.
<pre> $ arm-linux-gcc -v</pre>

==== codesourcery ====
[http://www.codesourcery.com/sgpp/lite/arm/portal/package3696/public/arm-none-linux-gnueabi/arm-2008q3-72-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2 codesourcery arm-none-linux-gnueabi]

==== self made ====

ftp://ftp.gnu.org/gcc
binutils, make, ...
sourcen holen, kompilieren

=== Cross Compiling ===
Sobald die Toolchain richtig aufgesetzt ist kann man anfangen, seine Programme zu übersetzten.

Dazu gibt es mehrere Möglichkeiten. Die erste ist der direkte Aufruf vom Compiler oder mittels eines "festen" Makefiles. Die zweite, wahrscheinlich Häufigste, ist das ausführen eines configure-Scriptes bevor der make-Vorgang gestartet wird.

* Das einfache aufrufen des Compilers
Dazu ein einfaches Hello-World Programm:
<c>
#include <stdio.h>

int main() {
   printf("hiho\n");
}
</c>

Compiliert wird das Programm ganz einfach so:
<pre>$ arm-linux-gcc <name.c> -o <name></pre>
Danach wird die Datei ''<name>'' an das Board [http://www.mikrocontroller.net/wikisoftware/index.php?title=Mini2440&action=submit#.C3.9Cbertragen_von_Daten.2FProgrammen_ins_Flash übertragen]. 
Sobald ''<name>'' auf dem Board ist, kann es ausgeführt werden:
<pre> $ ./<name></pre> 
Eventuell fehlen die Rechte:
<pre> $ chmod +x <name></pre>

* ./configure-Scripte
Hier sieht es schon ein klein wenig schwieriger aus, ist es aber eigentlich nicht.
''Normalerweise'', aber '''nicht immer''', sieht das compilieren eines Programms für das mini2440 so aus:
<pre> $ HOST=arm-linux ARCH=arm ./configure --build=arm-linux- --your-options
 $ make
</pre>
Man muss dem configure-Script lediglich angeben, für welche Architektur das Makefile konfiguriert werden soll und welchen Compiler er dafür nehmen soll.

* autogen
Noch eine ....


=== Linux-Kernel ===
make emnuconfig

=== root-fs ===
roooooooot

=== Framebuffer ===
==== Font wählen ====
==== Rotation ====

=== Bootloader vivi/supervivi ===
=== Bootloader uboot ===

Der Bootloader uboot wurde von "buserror" soweit an das mini2440 angepasst, dass er mehr oder weniger läuft.
Für die verschiedenen Boards gelten also auch leicht verschiedene Anweisungen um uboot ins Wasser zu bekommen.

Das git und die Seite von "buserror" ist [http://code.google.com/p/mini2440/ hier] zu finden.

Boards:
* 64MB 
* 128MB
* 256MB
* 1GB

== Multimedia ==

=== Abspielen von Audio-Daten ===
=== Aufnehmen von Audio-Daten ===
=== Abspielen von Video-Daten ===
=== Kamera-Interface ===

== Hardware ==
Nahezu alles ist über die verschiedenen Header auf dem Board zu erreichen
=== Pinouts ===
[[Bild:mini2440_pinout.jpg|450px]]
{| class="wikitable"
|+ '''Audio IN'''
|-
! Pin || Funktion
|-
| 1 || IN
|-
| 2 || GND
|-
| 3 || IN
|}

{| class="wikitable"
|+ '''CON1'''
|-
! Pin Board || Pin SUB-D 9 || Funktion
|-
| 1 || 2 || TX
|-
| 2 || 3 || RX
|-
| 3 || || VCC 5V
|-
| 4 || 5 || GND
|}

{| class="wikitable"
|+ '''CON2, CON3'''
|-
! Pin Board || Funktion
|-
| 1 || TX
|-
| 2 || RX
|-
| 3 || VCC 5V
|-
| 4 || GND
|}

==== onboard Hardware ====
* 24C08
* Buttons
* LEDs

=== [[I2C]] ===
==== 24XX [[EEPROM]]s ====
==== [[Port-Expander]] ====
=== [[Serial Ports]] ===
=== [[SPI]] ===
=== [[PWM]] ===
==== onboard buzzer ====
=== [[ADC]] ===
==== Touchscreen ====
==== onboard Poti ====
=== GPIO ===
==== Grundlagen ====
==== GPIO lesen/schreiben über sysfs ====
==== GPIO direkt ansprechen ====
==== Ein Kernelmodul und das passende Programm dazu schreiben ====
==== C-Beispiele für onboard LEDs/Buttons ====
=== Real Time Clock ===

== Andere Betriebssysteme ==

=== uCos2 ===
=== Windows CE ===
=== FreeRTOS ===



== Ohne Betriebssystem ==

=== Entwicklungsumgebung ===
=== Beispiele ===


== Wo kaufen? ==

Zu beziehen ist das Board entweder über Ebay, meist aus China, oder bei [http://www.watterott.com watterott].

== Links und Quellen ==
Hier sind ausserdem alle verlinken Seiten, Wikis, PDFs usw nochmals aufgelistet.

[[Category:ARM-Boards]]