/*~~NOTOC~~*/ [[http://eshop.acmesystems.it/?id=FOXG20|{{ http://eshop.acmesystems.it/eshop_acmesystems_it/FOXG20/foxg20.jpg?260|FOX Board G20}}]] Welcome to official web site related to the **[[http://eshop.acmesystems.it/?id=FOXG20|FOX Board G20]]** a Linux Embedded Single Board Computer built on an Atmel ARM9 CPU at 400MHz with 64MByte of RAM, 8MByte of dataflash memory, 2 USB 2.0 host ports, 1 Ethernet port, a microSD socket and a lot of GPIOs, serial interfaces, etc. ([[http://eshop.acmesystems.it/?id=FOXG20|learn more about FOX Board G20 features and prices]]). FOX Board G20 is an appliance of the **[[http://eshop.acmesystems.it/?id=NETUSG20|Netus G20 board]]** a 40x40 mm, 8 layers CPU module designed by [[http://www.acmesystems.it|Acme Systems]] to reduce the time-to-market and production costs of the Atmel AT91SAM ARM9 boards design ([[http://eshop.acmesystems.it/?id=NETUSG20|learn mode about Netus G20 features and prices]]). On this web site you will find tutorials, examples, schematics, news, articles, links, forums, etc. related to the hardware and software aspects that will help you to design your own embedded applications. The development tools for any languages are fully open source and freely downloadable from the Web as shown below. A starter kit with all the hardware you need to getting start with the FOX Board G20 may be purchased on-line from our eShop ([[http://eshop.acmesystems.it/?id=COMBO-2|buy the starter kit]]). ===== Products previews ===== [[rfc:daisy|{{:daisysmall.jpg?nolink |}}]] Daisy is a new cabling system and a set of new modules that Acme Systems are designing to make easy and fast the design of new devices based on FOX Board G20/Netus G20. [[rfc:daisy|Read the preview...]] ===== Troubleshootings ===== * [[troubleshootings|The file systems goes in read-only mode]] * [[troubleshootings#first_sector_erased_at_boot_time|The first sector of dataflash is erased when the PA31 line (J6.21 on the FOX Board G20) is mantained low at startup]] This is a software feature currently implemented on any FOX Board G20 that could give problems if ignored during hardware development of project based on Netus G20 or FOX Board G20 * [[troubleshootings#the_fox_board_g20_doesn_t_work_without_the_rtc_backup_battery|The FOX Board G20 doesn't work without the RTC backup battery]] This problem affects the FOX Board G20 shipped before March 9th, 2010 * [[troubleshootings#the_board_hangs_after_romboot_message_on_the_debug_port|The board hangs after RomBOOT message on the Debug Port: CASE 1]] This problem affects the FOX Board G20 shipped before December 20th, 2009 ===== Project examples ===== [[miniproject:temperature_logger|{{:tlogger_icon.png?nolink |}}]] [[miniproject:temperature_logger|Temperature logger]]. How to build a Web-enabled temperature logger using a 1-wire thermal sensor, Python, PHP, SQLite, FusionCharts, etc. ===== New products ===== [[http://eshop.acmesystems.it/?id=EPS|EPS - Extended Power Supply module]]. ===== User projects ===== * **BlueTweeter** by Daricom is a bluetooth device designed to send multimedia messages to cellphones, PDAs, smartphones… and to any device which is able to accept bluetooth connections and which is placed at most about 100 meters from the BlueTweeter ([[http://www.daricom.it/bluetweeter/en/bluetweeter|visit the home page]]). * **Photoelectric pallet load detection device** by Peter Dahlman ([[http://peterdahlman.wordpress.com/2010/04/22/photoelectric-pallet-load-detection-device/|visit the home page]]). * **FOXBOXG20** by Kdev ([[http://www.kdev.it/joomla/The_News/Latest_News/New_FoxBox_G20_2009122198.html|visit the home page]]) a SMS/MMS gateway and networking monitor equipment. ===== Basic tutorials ===== * [[tutorial:gettingstarted|Getting started with the FOX Board G20]] * [[tutorial:howtodiscovertheipaddress|Discovering the IP address]] //How to find the FOX IP address// * [[tutorial:ssh_access|Using the SSH session]] //How to access the command line prompt (shell)// * [[tutorial:scp_access|Using the SCP session]] //How to transfer and edit files on the FOX// * [[tutorial:web_access|Access to the WEB server]] * [[tutorial:static_ip_address|How to set a static IP address]] ===== Software Dev Kit ===== FOX Board G20 is a full features Linux systems and as like as any other Linux system a lot of different languages and developing methods are available from the Open Source universe. Acme Systems doesn't release any official Software Development Kit (SDK) for the FOX Board because is a no-sense on this environment, otherwise we suggest how to identify and use the powerfull, free and standard tools available on Internet. Below is a non-comprehensive and continuously updated list of IDE, languages, tools, compilers, cross-compilers, interpreters, byte-code generators, etc, etc. useable to develop code for your FOX Board G20. ==== In-board compilers ==== Using this method you don't need to install any SDK on your PC. You can edit and run the code directly on the FOX Board: * [[:tutorial:c|Installing the C compiler for in-board development]] * [[:tutorial:cpp|Installing the C++ compiler for in-board development]] ==== Cross compilers ==== * [[:tutorial:eclipse|C/C++ development using Eclipse on Windows systems]] * [[:tutorial:install_cross_compiler|Installing the toolchain to cross compile the Linux Kernel and non-Kernel applications]] ==== Interpreters ==== By definition the interpreted languages are executed directly on the target system so you can edit the source code directly on the FOX filesystems and run in from the command line: * [[:tutorial:java|Java]] //How to install the Java Development Kit and execute a simple Hello World! example//. * [[:tutorial:python|Python]] //Python is pre-installed by default. This articles illustrates how to run a simple Hello World! example//. * [[:tutorial:perl|Perl]] //How to install the Perl interpreter and execute a simple Hello World! example//. * [[:tutorial:yabasic|Basic]] //How to install the yaBasic interpreter and execute a simple Hello World! example//. * [[:tutorial:php|PHP]] //PHP is pre-installed by default. This articles illustrates how to run a simple Hello World! example and see it on your browser//. * [[:tutorial:shell_script|Shell scripting]] //The shell is installed by default on any Linux systems. This articles illustrates how to run a simple Hello World! example//. ==== Linux ==== * DEBIAN: [[tutorial:compiling_the_linux_kernel|Buildind the Linux Kernel]] * OPENWRT: [[http://wiki.openwrt.org/doc/howto/build|Building Linux OpenWrt]] * [[tutorial:devmem2|Devmem2]] //a simple utility to read and write the CPU registers// ===== Real Time environments ===== * [[http://www.federicololli.com/xenomaifoxg20.htm|Xenomai on FOXG20 by Federico Lolli]]. Xenomai is a real-time development framework cooperating with the Linux kernel, in order to provide a pervasive, interface-agnostic, hard real-time support to user-space applications, seamlessly integrated into the GNU/Linux environment. ===== Peripherals ===== ==== USB ==== * [[tutorial:webcam|Webcam streaming]] * [[tutorial:wifi|Wi-Fi dongle]] * [[tutorial:barcodescanner|Using a Barcode Scanner]] ==== I2C ===== * [[tutorial:srf02|Using the SRF02 Ultrasonic range finder in I2C mode]] ==== 1-wire ==== * [[tutorial:1wire|Using 1-wire Dallas DS18B20 thermal sensor]] * [[http://owfs.org/index.php?page=foxboard-g20|OWFS 1-wire filesystem]] ==== SPI ==== * [[http://helico.locklab.fr/2010/06/25/spi-devices-on-foxg20-board/|SPI devices on FoxG20 board]] by Antoine Durand ==== A/D lines ==== * [[contributes:antoniogalea:at91_adc|Using the analog to digital converter]] by Antonio Galea ==== PWM lines ==== * [[contributes:antoniogalea:soft_pwm|A kernel module for generating PWM signals]] in bit-banging mode by Antonio Galea ==== Serial ports ==== * [[tutorial:serial_port|Using the serial ports]] How to test and use the serial ports * [[tutorial:4dsystems_oled|Using 4DSystems oLed]] How to wire and use a 4D systems oLed graphic display ==== General purpose I/O ==== * [[tutorial:gpio|GPIO lines]] Blink-a-led and press-a-button examples using the default sysfs interface * [[hw:foxg20pinout|FOX Board G20 pinout]] ==== Carrier boards ==== * [[tutorial:foxgm|FOXGM board]] Getting start with FOXGM extension board ==== Others ==== * [[tutorial:sensirion|Sensirion Humidity and Temperature sensor]] Under construction ===== Bootable microSD ===== * NEW [[dev:binary-repository|Binary snapshots]] Binary files usefull to create bootable microSDs * [[dev:bootable-microsd|How to create a bootable microSD.]] Part1: Partition & Format * [[dev:fill_the_microsd|How to create a bootable microSD.]] Part2: Copy the kernel image and rootfs contents * [[dev:microsdcopy|Backup your bootable microSD]] * [[howtos:update_the_kernel_image|Update the kernel image from the binary repository]] ===== Boot loader and In-System programming ===== * NEW [[dev:acmeboot|AcmeBoot - Boot the Kernel Linux from the microSD without u-boot]] * NEW [[dev:pizzica|PIZZICA a simple Python ISP utility]] to change the default boot loader on Dataflash The following articles are obsolete using AcmeBoot instead of u-Boot: * [[dev:create_uboot_env|Create foxg20-script.bin u-Boot environment file]] * [[dev:factory-default|Program the serial dataflash memory]] Reset the 8MB dataflash to the factory default * [[dev:sam-ba|In-System programming with SAM-BA]] Small guide to the Atmel ISP utility to have access to the RAM and Dataflash memory * [[dev:uboot|u-Boot patch and compiling]] How to rebuild U-Boot starting from sources ===== Mini how tos ===== * [[howtos:ftp_python_client|Upload a file to a FTP server in Python]] * [[tutorial:compiling_linux_device|Compiling Linux Device Drivers]] ===== Funny stuff ===== * [[funnystuff:time-laps|How to make a time-lapse video]] ===== Hardware references ===== * [[hw:foxg20pinout|FOX Board G20 pinout]] * [[http://foxg20.acmesystems.it/download/FoxG20_3.pdf|FOX Board G20 schematic]] * [[hw:lxvsg20|FOXG Board 20 vs FOX Board LX832]] * [[hw:netusg20pinout|Netus G20 pinout]] * [[http://foxg20.acmesystems.it/download/netusg20_2mech.pdf|Netus G20 mechanical dimensions]] * [[http://eshop.acmesystems.it/?id=NETUSPS1|Netus PS1 - Quad power supply module]] * [[http://foxg20.acmesystems.it/download/netus_male_connector_05412.pdf|Netus G20 male connector]] * [[http://foxg20.acmesystems.it/download/netus_female_connector_14635.pdf|Netus G20 female connector]] * [[http://www.atmel.com/dyn/resources/prod_documents/doc6384.pdf|AT91SAM9G20 microprocessor datasheet]] ===== Forums and FAQ ===== Before to [[http://www.acmesystems.it/?id=427|send and email or call Acme Systems]] please note that we are hardware designers and not Linux gurus so try to post your software questions on the [[forums|FOX Board G20 forums]] to be sure that all the contributors of this site and the large software developers community will read your questions. * [[faq|FAQ]] and [[troubleshootings|Troubleshootings]] * [[forums|Forums]], [[http://foxg20.acmesystems.it/acmenews.rss|RSS feed]] and [[IRC]] * [[books|Books about Linux]] * [[links|Links]] /* * [[svn|Open Source Bay on SourceForge]] */ ======Terms and conditions====== Acme Systems provides this documentation "as is" without warranty or guarantees of any kind. A great deal of effort has gone into making this documentation as correct as possible but, due to the huge amount of info incoming from the developer communities, it's always under construction . Acme Systems doesn't provide any direct support for the Open Source preinstalled software but provides, through these pages and forum posts, all the information to install, use and update the software environments runnable on the FOX Board/Netus G20 platform. Please note that all the preinstalled softwares, used on the Acme Systems products, are Open Source and so you have to check by yourself the license terms provided by each author (usually the GPL) before use it in any commercial or not product. ====== Contributes ====== Many thanks for their contribute on this documentation to: Lee McLoughlin, Claudio Mignanti, Davide Cantaluppi, Riccardo Ventrella, Stefano Barbato, Sebastien Philippe, Roberto Fasulo, Marcus Folkesson, Andrea Leganza, John Crispin, Luca Pascarella, Marco Cavallini, Tiziano Galizia, Antonio Galea, Matteo Carnevali and to the developers community of the Open Source softwares mentioned on it. * [[contributes:main|Read more about the contributors]] If you have a web site with your project based on the FOX Board G20 or other materials useful for the FOX users please send us the link to [[foxg20@acmesystems.it]]. ====== Linux distributions ====== By default the FOX Board G20 boots Linux from the microSD card. It's possible to buy a ready-to-use microSD card or create it by yourself following [[dev:bootable-microsd|this tutorial]]. Here you can find some distributions already installed by the FOX users and used by Acme Systems to write the tutorials but thanks to the ARM9 CPU and to the hardware compatibility with the Atmel AT91SAM9G20-EK evaluation kit a lot of other enviroments can be installed. If you successfully tried other environments please send us any related useful information to add it on this website. [[debian:start|{{:debian_logo.jpg?nolink|}}]] [[debian:start|Debian on FOX Board G20 documentation index]]\\ [[debian:how_to_cross_compile_a_kernel_and_create_the_debian_root_file_store|How to build Debian for FOX Board G20]]\\ Thanks to Lee McLoughlin for this porting [[contributes:claudiomignanti:start|{{:openwrt-logo.png?nolink|}}]]\\ [[contributes:claudiomignanti:start|OpenWRT on FOX Board G20 documentation index]]\\ Thanks to Claudio Mignanti for this porting [[contributes:davidecantaluppi:start|{{:icon-gentoo.png?nolink|}}]] [[contributes:davidecantaluppi:start|Brief introduction to Gentoo]]\\ [[contributes:davidecantaluppi:kernelbuilding|How to build Gentoo for FOX Board G20]]\\ Thanks to Davide Cantaluppi (http://www.kdev.it) for this porting. {{:openembedded.jpg?nolink|}} **KaeilOS** is an embedded linux GNU/GPL distribution composed of a collection of the best publicly available Open Source packages. Version 4.00 available since January 2009 has joined **OpenEmbedded** project offering a wider selection of packages and recipes. **KOAN SAS** (http://www.kaeilos.com/) the italian software system integrator that made KaeilOS offers also a commercial support on it. **Riccardo Ventrella** wrote a tutorial for who wants to test it quicly on the FOX Board G20: [[contributes:riccardoventrella:openembedded|How to build a FOX G20 Linux distro with OpenEmbedded]] ====== Hi-res photos ====== This is a list of hi-res photo useful for articles, catalogs, web pages, brochures, etc. Feel free to use them but please don't forget to mention the author Roberto Fasulo. [[http://netus.acmesystems.it/photo/NetusG20.jpg|Netus G20]]\\ [[http://netus.acmesystems.it/photo/NetusG20_top.jpg|Netus G20 top side]]\\ [[http://netus.acmesystems.it/photo/NetusG20_bottom.jpg|Netus G20 bottom side]]\\ [[http://netus.acmesystems.it/photo/NetusG20_detail_1.jpg|Netus G20 detail 1]]\\ [[http://netus.acmesystems.it/photo/NetusG20_detail_2.jpg|Netus G20 detail 2]]\\ [[http://netus.acmesystems.it/photo/FOXBoardG20.jpg|FOX Board G20]]\\ [[http://netus.acmesystems.it/photo/FOXBoardG20_top.jpg|FOX Board G20 top side]]\\ [[http://netus.acmesystems.it/photo/FOXBoardG20_bottom.jpg|FOX Board G20 bottom side]]\\ ====== eShop ====== {{eshop>logo:NULL}} {{eshop>large:COMBO-2}} {{eshop>large:FOXG20}} {{eshop>large:DEBM2G}} {{eshop>large:GTOM2G}} {{eshop>large:TUXCASE}}