Home
iMX233-OLinuXino-MICRO
Contents
1. Resistive touchscreen controller Temperature sensor controller Absolute accuracy of 1 396 Security Features Read only unique ID for digital rights management algorithms Secure boot using 128 bit AES hardware decryption SHA 1 hashing hardware Customer programmed OTP 128 bit AES key is never visible to software B External Memory Interface EMI Provides memory mapped load store access to external memories Supports the following types DRAM 1 8V Mobile DDR Standard 2 5V DDR1 m Wide Assortment of External Media Interfaces High speed MMC secure digital SD Hardware Reed Solomon Error Correction Code ECC engine offers industry leading protection and performance for NANDs Hardware BCH ECC engine allowing for up to 20 bit correction and programmable redundant area m Dual Peripheral Bus Bridges with 18 DMA Channels Multiple peripheral clock domains save power while optimizing performance Direct Memory Access DMA with sophisticated linked DMA command architecture saves power and off loads the CPU m Highly Flexible Display Controller 8 bit data ITU R BT 656 D1 digital video stream output mode PAL NTSC with onthe fly RGB to YCbCr color space conversion Flexible input formats W Pixel Processing Pipeline PXP Provides full path from color space conversion scaling alpha blending to rotation without intermediate memory access Bi linear scaling algorithm with
2. HW_OCOTP_ROM4 DISABLE SPI NOR FAST READ 6 Not blown HW OCOTP ROMS HW OCOTP 6 Reserved 7 Not blown HW OCOTP ROM7 SSP SCK INDEX 11 8 VERSION SD_BUS_WIDTH 13 12 Current value 0 00200008 New value 0 00200008 ek nite 2 7 Building the Debian Linux image Note that building the Linux image from scratch is a time consuming task Even with powerful machine and fast internet connection it might take few hours compiling Some Linux distributions might lack the tools required to compile build execute scripts download from repository how to get those is not discussed below The Linux image is created and downloaded from https github com Freescale fsl community bsp platform For the test here we used Debian 6 0 with GNOME visual libraries The steps we did 1 From the terminal created folder bin in home folder user dist mkdir bin user dist cd bin Add bin directory to PATH in order to do the next steps easier Else navigate to the right folders 2 Installed repo utility needed for the bitbake file fetching from the repository user dist curl https dl ssl google com dl googlesource git repo repo gt bin repo user dist chmod bin repo Page 11 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 3 Created directory for the project and download the BSP source from the git repository user dist mkdir fsl community bsp user dist cd fsl communi
3. OLinuXino MICRO Open source sinole board Linux computer USER S MANUAL Revision J January 2013 Designed by OLIMEX Ltd 2012 lead free All boards produced by Olimex LTD are ROHS compliant OLIMEXO 2012 OLinuXino MICRO User s Manual DISCLAIMER 2012 Olimex Ltd Olimex logo and combinations thereof are registered trademarks of Olimex Ltd Other product names may be trademarks of others and the rights belong to their respective owners The information in this document is provided in connection with Olimex products No license express or implied or otherwise to any intellectual property right is granted by this document or in connection with the sale of Olimex products The Hardware project is released under the Creative Commons Attribution Share Alike 3 0 United States License You may reproduce it for both your own personal use and for commertial use You will have to provide a link to the original creator of the project http www olimex com on any documentation or website You may also modify the files but you must then release them as well under the same terms Credit can be attributed through a link to the creator website http www olimex com The software is released under GPL It is possible that the pictures in this manual differ from the latest revision of the board The product described in this document is subject to continuous development and improvements All particulars of the product and its use contained
4. OLIMEXO 2012 OLinuXino MICRO User s Manual 2 4 Powering the board The board is powered either via the PWR jack or via a battery It should be supplied by 5V source with maximum current of 1A from the power jack All measures below are taken at 5V If measuring the current consumption it should be around 0 06A before initializing all the peripherals IMPORTANT We discovered a situation which might leave some of the SD cards iM X233 OLinuXino SD in unrecoverable state when powering OLinuXino MICRO The problem might occur if two specific conditions are met simultaneously 1 Plugged iMX233 OLinuXino SD micro SD card with holographic sticker on its back side some of the cards we have distributed are from a brand that places holographic sticker on their backs the other half lack such a sticker 2 Plugged USB SERIAL CABLE F at the moment when powering the board If you happen to have received SD card with holographic sticker on its back side and you use it with OLinuXino MICRO and you plug USB SERIAL CABLE and then you power the board there is a chance of malfunction of the SD card There are two possible workarounds to protect the SD card The first one is simpler and the second one requires some soldering experience Workaround 1 First insert the iMX233 OLinuXino SD card and then power the board and if powering the board from a battery also press the PWR button Wait 4 5 seconds and then connect the USB SERIAL CABLE F After the i
5. OLinuXino MICROit is advisable to first insert the iMX233 OLinuXino SD card and then power the board if using battery also press the PWR button Wait 4 5 seconds and then connect the USB SERIAL CABLE F Please also check 2 4 Powering the board for detailed info Note on how to use the U DEBUG with USB SERIAL CABLE F which has RED GREEN BLUE wires GND BLUE RX INPUT GREEN TX OUTPUT RED You have to connect to OLinuXino MICROU DEBUG connector in this sequence BLUE wire to pin 3 GND GREEN wire to pin 2 TX RED wire to pin 1 RX You can also check the pin names at the bottom of the board under the U DEBUG header 6 1 2 SJTAG debug The second interface is the Serial JTAG SJTAG one wire interface It works with various external JTAG debugger dongles through a Freescale defined FPGA CPLD SJTAG supports the Green Hills Slingshot and ETM probe debugger dongles as well as those made by ARM Abatron and Lauterbach Note that the SJTAG interface comes without plastic header mounted The HW DIGCTL CTRL USE SERIAL JTAG bit in the digital control block selects whether the Page 24 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual one wire serial JTAG interface or the alternative six wire parallel JTAG interface is used There are other options in the digital control block which might interest you and our advice is to check the iMX233 s datasheet released by Freescale SJTAG The pin names are also written at the bottom of
6. and the consecutive connector pin number in the table below The ones filled with Not implemented doesn t have Linux support by the time of writing and will be updated overtime Linux GPIO is the one you should use in Linux the one in the datasheet OLinuXino name is the pin as written on the bottom of the board OLinuXino GPIO Connector is the consecutive number of pins with BAT being Pin 1 and GND 40 Note that if OLinuXino Name starts with P and then is followed by a number X the PX is the name written on the bottom of the board under the connector with white ink If OLinuXino Name is other text it is a signal used for the hardware of the board but still can be controller by the Linux it can t be found at the GPIO connector though The Linux implementation of pins Linux 7 Linux 5 7 2 GPIO iMX OLinuXino Name OLinuXino CON OLinuXino OLinuXino CON GPIO iMX 233 GPIO 233 GPIO pagis PIN9 CON1 11 32758533 Eme E com PIN11 1 13 PIN24 CON1 26 ee PIN12 CON1 14 W 22208 PIN26 1 28 EIN PIN13 CON1 15 PIN22 CON1 24 Ex PIN14 CON1 16 56 PIN21 CON1 23 JTAG_TDO1 Not ES PIN15 CON1 17 55 1 CMD implemented PIN16 CON1 18 LED1 EL mM PIN PIN18 CON1 20 PIN31 CON2 24 Page 31 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual we sss er ree O La omm
7. closed soldered provides 3 3V at the pin 30 of CONI The default position is open 6 11 4 Boot mode selecting jumpers The boot mode is discussed in chapter 6 11 of this manual 6 12 Additional hardware components The components below are mounted on OLinuXino but are not discussed above They are listed here for completeness Reset button used for hardware reset of the board Power button when Linux is running pressing BUT will put the board in low power mode when powered by battery BUT is used to initially power up the board and pressing the board again after it is powered will put it low power mode Recovery button REC when the board is put to sleep REC can be used to wake up the board 512 32M x 16 MBit DDR SDRAM the exact memory used in the first revisions of the board is Xylinx HY5DU121622D LED1 Page 36 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 6 13 Accessories Here you will find additional information for Olimex products you can use with OLinuXino MICROpurchase 6 13 1 USB SERIAL CABLE F The cable for the DEBUG interface that can be purchased for additional cost has three cables It is important to specify in your purchase order whether you want the USB SERIAL CABLE F variant with male of female connectors The wires follow the following color pattern GND BLUE RX INPUT GREEN TX OUTPUT RED You will need a drivers that can be downloaded from the page of USB SERIA
8. cropping and letterboxing Alpha blend BITBLT color keying Memory efficient block based rotation engine W Integrated TV Out Support Integrated PAL NTSC TV encoder fully pipelined to display controller s D1 resolution output stream Integrated low power 10 bit Video DAC VDAC for composite analog video output m Data Co Processor DCP AES 128 bit encryption decryption SHA 1 hashing High speed memory copy m Three Universal Asynchronous Receiver Transmitters UARTs Two high speed application UARTs operating up to 3 25 Mb s with hardware flow control and dual DMA Debug UART operates at up to 115Kb s using programmed I O Page 19 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual m 2 Master Slave DMA control of an entire EEPROM or other device read write transaction without CPU intervention m Dual Synchronous Serial Ports for SPI MMC SDIO Triflash 1 bit 4 bit and 8 bit MMC SD SDIO modes Compliant with SDIO Rev 2 0 SPI with single dual and quad modes m Four Channel 16 Bit Timer with Rotary Decoder Five Channel Pulse Width Modulator PWM B Real Time Clock Alarm clock can turn the system on Uses the existing 24 MHz XTAL for low cost or optional low power crystal 32 768 kHz or 32 0 kHz customer selectable via OTP B Customer Programmable One Time Programmable ROM via Integrated eFuse Block Resistor less boot mode selection 128 bit boot mode cry
9. is explanation of the different peripherals in the following chapters of the manual Page 15 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 3 1 Layout top view SJTAG NC NC NC er OLinuXino Micros B SJTAG SD card connector Composite id SMD jumpers PWR jack Da ZZ PURER RECGUERY gt NK NK um U_DEBUG CON1 Power button REC button Page 16 of 47 OLinuXino MICRO User s Manual OLIMEXO 2012 3 2 Layout bottom view ZI 27 25 CON2 4 Composite video 4 aac taste 5 RM3 RM2 IAP Boi stam Jx a CA 22 NT m x USB HOST HE MODE nT M BOOT SELEC Q OLIMEX COM DEU CON1 Made in Bulgaria 2012 26 25 24 23 22 21 20 19 18 17 16 15 14 13 1242 10 9 as i mm mm m wr ww NON ONN ON N ON ON IM URC ICR IR se oO T BOOT MODE s L7 LN 7 PWR jack Page 17 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual CHAPTER 4 THE iMX233 MICROCONTROLLER 4 Introduction to the chapter In this chapter is located the information about the heart of OLinuXino its microcontroller The information is a modified version of the datasheet provided by its manufacturers 4 1 The microcontroller 926 CPU Running at 454 MHz Integrated ARM926EJ S CP 16 Kbyte data cache and 16 Kbyte instruction cache One wire JTAG interf
10. o wara wasa pecie Below is the schematic of GPIO CON AQOT NODE SELECT pei naa j 3 3U 12C Naster uaita for 2704 detaagger connecdan A 3 3 3 30 SD ffC 1 Default fO 4 2 4 BOUT MODE SELEUI pEgRuG punta GPIO You can see the signals needed to form UEXT connector SJTAG debug interface and audio interface marked with purple Thanks to David Whittaker some of the above information can be found in compact variant at a table he compiled https docs google com spreadsheet ccc key 0AspkrcYcY5bWdEB6WC1xRIp5bERjclhwVnlQZDVmeUE Page 32 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 6 5 USB HOST The USB hosts and the Ethernet are controller by the iMX233 controller Important The USB of OLinuXino Micro can communicate directly only with High speed or Full speed USB devices The majority of keyboards and mice are low speed devices A good solution for plugging a keyboard or a mouste to the Micro is to use a USB hub between your device and OLinuXino Micro using such a hub has the additional benefit of providing additional USB slot which can be used for example to mount flash m
11. 1 Use one wire serial JTAG mode It is good idea to check the datasheet of the M X233 processor for all the options in the digital control block The processor s datasheet should be always the first piece of paper you consult when Page 25 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual dealing with electronics SSP1 SCK CNN Notice that the pad numeration is written at the bottom of OLinuXino MICROunder the microSD card connector Please check the manual part for microSD card for a schematic of the pins Page 26 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 6 2 SD MMC slot The microSD card slot is a standard 8pin connector We have tested a number of microSD cards on the OLinuXino boards and all of them worked fine regardless manufacturer or capacity However keep in mind that some of the lower quality microSD cards might draw too much current from the slot which might cause power state problems If you suspect the microSD card is causing problems please try using another one of better quality for better results microSD card connector aem e o je END e peee enm je Notice that the pad numeration is written at the bottom of OLinuXino MICROunder the microSD card connector When removing the card please make sure that you release it from the connector by
12. 37 6 13 1 USB SERIAL CABLE BE ssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssees 37 CHAPTER 7 BLOCK DIAGRAM AND 38 7 Introduction to the Chapter scccccsssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssseses 38 Page 4 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual CHAPTER 1 OVERVIEW 1 Introduction to the chapter Thank you for choosing the OLinuXino single board computer from Olimex This document provides a user s guide for the Olimex OLinuXino MICRO board As an overview this chapter gives the scope of this document and lists the board s features The differences between the members of the OLinuXino family are mentioned The document s organization is then detailed The OLinuXino development board enables code development of applications running on the microcontroller i M X233 manufactured by FreeScale Semiconductor OLinuXino is an open source open hardware project and all documentation is available to the customer 1 1 Features jMX233 926 processor at 454Mhz 64MB RAM SD card connector for booting the Linux image TV PAL NTSC video output 1 USB High Speed Host three Buttons 2x30 pin GPIO for connection of other hardware PCB dimensions 3 00 x 1 70 76 2mm x 43 2mm Nominal dimensions 3 40 x 1 70 86 4mm x 43 2mm Page 5 of 47 OL
13. CA 22076 3 10 2 z 5VEXT T 637 f EH mem 104 vov DCDC aa CISgzzuFIE 3v Bl unen xd cap s 208 I Ri Mounted lan capex cups 3d rec uro KE IN2SILCD RS 5 1 Ss DOS DCDC VDDA 5 e m E 3 E arms 51 m ERU 1 1 45g 10 22uH 1 5A YS7577x5mm gt WRNISSP2 em C228 1001 VDDXTAL 124 venie al DTG I BOOT MODE SELECT LCD DATA 33v sao ES Do7A CD 018 015 BOOTMODE Do bog cor boc RM3 Xo 121 DOSILCD PINT4 LCD D13 1 us 0 o o 0 H PINAILCD DO xTA
14. IBLE PROCESS BURNING THE WRONG FUSES MIGHT DAMAGE OLINUXINO IRREVERSIBLY BURNING WRONG FUSES MIGHT CAUSE BOOT PROBLEMS BURN FUSES AT OWN RISK The bit burning is done via the USB of the computer connected to the OLINUXINO board and the BitBurner software To be able to burn the fuses you will need to connect a USB A to USB A cable between a computer and the board s USB HOST connector Download BitBurner from https www olimex com dev OLINUXINO iMX233 OLINUXINO BitBurner v1 0 4 6 zip Extract it and start the exe If you connect everything you should see and choose HID compilant device from the Select device drop down menu Page 10 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual Select device HID compliant device gt Ready Info Name OtpAccessPitc 3780 sb Select OTP register Internal name OTP Register Size 10896 bytes HW OCOTP CUSTO Date modified N A HW OCOTP CUST1 Info Type FileType 3600 Stmp HW_OCOTP_CUST2 OTP Register 24 Resource File Resource HW_OCOTP_CUST3 Address 0 8002 1 0 Tag Id 0 0001 Lock Bit 0x18 Product version 100 10902 1300 HW CRYPTOO 0x03 Component version 15624 300 600 HW OCOTP CRYPTO1 OTP Word 0x00 Language 0x0000 HW_OCOTP_CRYPTO2 Locked false HW CRYPTO3 Shadowed false HW OCOTP CUSTCAP download HW_OCOTP_LOCK SD_MBR_BOOT 3 Blown HW_OCOTP_ROM1 ENABLE_UNENCRYPTED_BOOT 4 Not blown HW_OCOTP_ROM2 HW_OCOTP_ROM3
15. ICRO Will not work with iMX233 OLinuXino MAXI and iMX233 OLinuXino MINI The latest price list can be found at https www olimex com prices How to order You can order directly from the web site or from any of our distributors Please visit http www olimex com for more info The full list of distributors can be found here https www olimex com Distributors Page 46 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 9 3 Product support For product support hardware information and error reports mail to support olimex com Note that we are primarily a hardware company and our software support is limited Please consider reading the paragraph below about the warranty of Olimex products Warranty and returns Our boards have lifetime warranty against manufacturing defects and components During development work it is not unlikely that you can burn your programmer or development board This is normal we also do development work and we have damaged A LOT of programmers and boards during our daily job so we know how it works If our board programmer has worked fine then stopped please check if you didn t apply over voltage by mistake or shorted something in your target board where the programmer was connected etc Sometimes boards might get damaged by ESD shock voltage or if you spill coffee on them during your work when they are powered Please note that warrany do not cover problems caused by unproper use shorts over vo
16. IMEXO 2012 1 2 The OLinuXino family OLinuXino MICRO User s Manual Table of comparison OLinuXino MICRO OLinuXino MINI OLinuXino MAXI Processor iMX233 454Mhz iMX233 454Mhz iMX233 454Mhz Ram MB 64 64 64 USB hosts 1 3 2 100 150 Mbit No WIFI option No WIFI option Yes WIFI option Ethernet GPIO connector 60pins 40pins 40pins Buttons 3 2 2 Reset button Yes Yes Yes DC power supply 5V 5V 16V 5V 16V Dimensions 3 40 x 1 70 3 70 x 2 65 3 70 x 2 65 Breadboarding Yes No No Audio IN connector No Yes Yes Audio OUT connector Yes Yes UEXT connector No Yes Yes Built in USB hub No Yes Yes 100Mbit Ethernet for the wired network of OLinuXino MAXI 150Mbit for the WIFI following 811 02n standard All three boards have the option to work with MOD WIFI RTL8188 which is USB WIFI modem with RTL8188CU chip and can be purchased separately MOD WIFI_RTL8188 can be connected to any of the OLinuXino boards via the USB OLinuXino MINI has additional option of having RTL8188CU hardware mounted If you wish RTL8188CU embedded in the device you should purchase OLinuXino MINI WIFI Choosing the embedded WIFI option will leave your USB HOSTs available for use 1 2 Target market and purpose of the board The boards from the OLinuXino family are ready to use easy to setup and are suitable for embedded programming enthusiasts Linux hobbyis
17. L CABLE https www olimex com dev usb serial cable html Page 37 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual CHAPTER 7 BLOCK DIAGRAM AND MEMORY 7 Introduction to the chapter On the next page you can find a memory map for this family of processors It is strongly recommended to refer to the original datasheet released by Freescale for one of higher quality 7 1 Memory addresses Below is the table with some of the most frequently used addresses For full list of addresses check the manual released by Freescale Chapter Memory Map Decode Device Mnemonic Start address End address Size block AHB On chip RAM OCRAM 0x00000000 0x00007FFF 32KB On chip RAM OCRAM 0x00008000 Ox3FFFFFFF alias External memory 0x40000000 Ox5FFFFFFF 512MB Default Slave 0x60000000 Ox7FFFFFFF 512M Page 38 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 7 2 Processor block diagram APBH er 45 5 DMA Control OC ROM Controller S M Bridge DMA M x S AHB to APBX 5 Bridge DMA S S 4 Port 2 Controller S SPDIF TX c lt PN ea AXI 4 2 BCH ECC mDDR DDR peice me lt M pies UART2 M USB Host PHY Multichanne ADC Touchscreen s Timer PWM RTC ALARM Watchdog Persistent Regs USB PHY Page 39 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 7 3 Physical memory map O
18. LO SLOD Dr EHe D PINTSILCD 012 33V EC Master 0 10 1 10 17 DUZH PINSILCD DO PINTZLCD DTI DOTT PNTCD DOT a pO3 CD 33V SPI Flash 1 Master 14 2 515 1 33VSPIFlash2 Master a pL PINSILCD D08 SSP2 MSO D3vNAND 0 1 0 0 pe m PINSILCD 007 1 starup waits tor TAG debugger connection T T E 33 SD MMC 1 Default 1 1 0 0 1 ass 476 e 18 E PINSILCD 33v SDIMNC 2 1 0 1 0 RM2 E PINAILCD E PINSILCD D02 USB DP 14 E PCD DOT USB DM 12 PINT LCD DOO HPL ud SVEXT 5VEXT 33V REG HPR Xd x HP VOND CON LINT INL 8 PIN22ILCD 1 NN SDA PINZO LCD_VSYNC PINTILCD 000 m PRISED DOTIK PRICED DOT PINSLCD DOZ AUARTI ipi PINSSLRADCO 04 apy AUARTI PINTLCD 003 AUARTI i 1 1 PINS2ILRAD 30 RAD AUARTIT 1 PINSILCD 004 i SCL 1 1 PWMO DUART TOD PINGILC SDA vec 1 1 x DANDIROTARY AIDUART RX 1 PINTILC B PINSLCD DOSISSPZ MISO voci OWMVROTARYBIDUART TX 1 PINGILCE SSP2 MOSI 1 1 PSWITC ROY PINSE MIST SSPZ SCK ssl M D EXT GPO mu de IDEO D SEL A Pa RAS TAK UD DeBus 1 1 SSPI DATAZIZC SDAUTAG RTUX 1 PINTALCD D13 PL DATA3SRI SSRLITAG TNS CD DI
19. PR 500 SORUTAG TRGT PINIGLCD DIS E YND AUDIO MCIMDGSSGAG4C PINT7ILCD DIS LINT NL L 1 PINTBLCD DI JUSE EN LINTINR 1 PINISLCD DOTCLK PIN2ULCD VSYNC PIN21 LCD 5 SDA d PINZZILCD ENIEC PINZNLCD DISP PINZALCD WR PIN2SLCO FS VIDEO PINZGILCD CS COMPOSITE VIDEO 545 1 4 r S Boom Mounted 1 odd 1 lH T e cA Composite Video 1 1 1 1 1 1 1 1 1 6 MicroSD f sp ro MICRO NAWU98S 2 111 R2 cup C EAS T a U DEBUG SJTAG ro PIN21LCD HSYNCI i 208 7 ssp1 sek fa PWMBDUART DO asy Du DATAT JE JUDUART DD 5 ScL HW scL SW 3 DATAT SJTAG Psw toot RMIG2 SSPT DATAZ 5 S 1 bg L ANDA k ou 1 POWER REC Button 1 1 eset Circui pease aw ibd POWER XTALI 2 td PSWIICH RT 1 19 SJTAG PSV T R6 VDDXTAL 1 5 Bre RESET 22k QI T1107A 6x3 8x2 5mm xTALO d 4 m RS 1 i H n EIN T1107A 6x3 8x2 5mm sce L UNT L USB HOST POWER SUPPLY CIRCUIT 5VEXT 5VEXT REG 5 2 USB_HOST SY6280 FBOBOSIGO0
20. R 2A 5V HOST PWR s 7 USB DM USB SV E VR USB DP USB DP ey e 1 Tan 3c 3 8 NA DTA114YKA beca Ra a cor AP123133 680mA 100nF Z2uF 63V 22uF 6 3V 22uF 6 3V FETI NA RLML6402 IUFM GVILOWESIUIOSCIE Mk 1mm 5 NA DTC114YKA iMX233 OLinuXino Micro_revision_B1 https www olimex com OLIMEX LTD Page 42 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 8 2 Physical dimensions Note that all dimensions are in mills Additionally the three highest elements on the board in order from the tallest to the shortest are dimensions without the PCB thickness 1700mil 1 Composite video connector 490 mil 1136 11 n N d 2 C50 C51 480 mil 2 3 48 470mi 250mil 230mil 1850mil 3000mil Page 43 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual CHAPTER 9 REVISION HISTORY AND SUPPORT 9 Introduction to the chapter In this chapter you will find the current and the previous version of the document you are reading Also the web page for your device is listed Be sure to check it after a purchase for the latest available updates and examples 9 1 Document revision Changes Modified Page Ao Initial Creation 05 07 12 Added notes USB compatibil
21. UXINO THEY ARE CONSIDERED SUITABLE ONLY FOR OLINUXINO Page 2 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual Table of Contents DI Eee ee eee eee 2 CHAPTER I OVERVIEN uuu sssssesssassassaqassshasqsssussssasssqusqaspsskas 5 1 Introduction to the chapter ua aaa eere rnnt ananas 5 2e TRENT 10 2 7 Buildin Debian Lin x IDIage u uuu e vesc eob see es ete Pe Vs eth peus a ta essa Pv 11 CHAPTER 5 CONTROL CIRCUITY ssasssssssssssssssses 21 5 Introduction to the Chapters 21 CHAPTER 6 CONNECTORS AND 23 6 Introduction to Glia Plessis u uuu uuu o sano a Cosas aseo oe aka be 23 6 1 2 SJTAG mtt eee 24 6 1 3 Classic JTAG debu uuu uu aasssasssususakasqssskasuassassashsssassssausassasassasssssawsqucsssiassuasusk 25 Page 3 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 6 5 USB HOST uuo dddivmdadu io rid 33 6 6 PWR T E A 33 6 12 Additional hardware components 36 6 192 A CCPSSOTIBS 12 00 10 el Rn 04 8 01 0 0 020
22. ace Resistor less boot mode selection using integrated OTP values 32Kbytes of Integrated Low Power On Chip RAM 64 Kbytes of Integrated Mask Programmable On Chip ROM 1 Kbit of On Chip One Time Programmable OCOTP ROM Universal Serial Bus USB High Speed Up to 480 Mb s Full Speed Up to 12 Mb s Full speed high speed USB device and host functions Fully integrated full speed high speed Physical Layer Protocol PHY Mass storage host capable uncertified by USB IF Power Management Unit Single inductor DC DC switched converter with multi channel output supporting Li Ion batteries Features multi channel outputs for VDDIO 3 3 V VDDD 1 2 V VDDA 1 8 V VDDM 2 5V and regulated 4 2V source Direct power from 5 V source USB wall power or other source with programmable current limits for load and battery charge circuits Silicon speed and temperature sensors enable adaptive power management over temperature and silicon process Audio Codec Stereo headphone DAC with 99 dB SNR Stereo ADC with 85 dB SNR Stereo headphone amplifier with short circuit protection and direct drive to eliminate bulky capacitors Amplifiers are designed for click pop free operation Two stereo line inputs Microphone input SPDIF digital out 16 Channel Low Resolution ADC 6 independent channels and 10 dedicated channels Page 18 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual
23. dencies needed for the compile build scripts Here are some but not all of the mandatory ones G diffstat texi2html chrpath gawk texinfo some git client To ensure you have the latest version supported with all the updates visit https github com OLIMEX OLINUXINO and https github com Ereescale fsl community bsp platform Page 12 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 2 8 How to blink the LED In this sub chapter you will find a way to achieve the most basic task in electronics the Hello World of electronics blinking the LED First we set the pin responsible for the LED as an output and we can set its value manually to high or low position make it blink manually The LED mounted on the board uses GPIO65 You can use external diode instead of the one mounted you have to look at the table The Linux implementation of pins in the hardware section to get the correct linux name for the GPIO pin echo out gt sys class gpio gpio65 direction echo 1 gt sys class gpio gpio65 value If you want to set the blink off you should change the value on the second line to echo 0 gt sys class gpio gpio65 value To show the info for all GPIOs ls sys class gpio To make it turn on turn off automatically e g blink we use the text redactor VI to write the Linux script echo out gt sys class gpio gpio65 direction while true do echo 1 gt sys class gpio gpio65 value sleep 1 echo 0 sys c
24. emories etc The signals follow the familiar and standard USB host pattern USB 2 level host SIGNAL 5V HOST 6 6 PWR Jack The power jack used is the typical 2 5mm one used by Olimex in most of our products You should provide 5 volts at 1 maximum to the board More info about the power supply be found chapter 5 of this manual Page 33 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 6 7 Headphones and line in connector The audio connectors are not mounted on OLinuXino MICRO but the signals needed can be found on 2 connector Check the CON1 and CON section for further info 6 8 Battery connector When using the battery connector keep in mind that it is an energy solution that wouldn t be able to power the board and all the peripherals The voltage of a 3 7V LIPO battery would be enough to power the processor and the memory but won t be enough to power the LAN and the USB hosts The pins are also written on the top of the board in the base of the connector 6 9 Composite video connector The composite video is the connector you should use if you wish OLinuXino MICRO video output on a monitor The signal is controlled by pin 104 from the i M X233 processor The signal is lead to the middle of the connector The outside part is the GND Page 34 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 6 10 Boot mode positions The iMX233 ca
25. his section helps you set up the OLinuXino development board for the first time Please consider first the electrostatic warning to avoid damaging the board then discover the hardware and software required to operate the board The procedure to power up the board is given and a description of the default board behavior is detailed 2 1 Electrostatic warning OLinuXino is shipped in a protective anti static package The board must not be exposed to high electrostatic potentials A grounding strap or similar protective device should be worn when handling the board Avoid touching the component pins or any other metallic element 2 3 Requirements In order to set up the OLinuXino MICRO optimally the following items are required 5V source of power with 1A maximum amperage SJTAG interface programmer USB hub USB splitter USB keyboard Monitor with composite interface or Personal Computer USB SERIAL CABLE SD card with Linux image Note that the board arrives without SD card or Linux image You can purchase a card with Linux separately It is recommended that the user has basic Linux experience Some of the suggested items can be purchased by Olimex for instance iMX233 OLinuXino SD SD card with the Linux image USB SERIAL CABLE F USB serial console cable female check 6 1 1 UART Debug for info how to connect it to the board 0605 power supply adapter for iMX233 OLinuXino MICRO Page 8 of 47
26. in this document are given by OLIMEX in good faith However all warranties implied or expressed including but not limited to implied warranties of merchantability or fitness for purpose are excluded This document is intended only to assist the reader in the use of the product OLIMEX Ltd shall not be liable for any loss or damage arising from the use of any information in this document or any error or omission in such information or any incorrect use of the product This evaluation board kit is intended for use for engineering development demonstration or evaluation purposes only and is not considered by OLIMEX to be a finished end product fit for general consumer use Persons handling the product must have electronics training and observe good engineering practice standards As such the goods being provided are not intended to be complete in terms of required design marketing and or manufacturing related protective considerations including product safety and environmental measures typically found in end products that incorporate such semiconductor components or circuit boards Olimex currently deals with a variety of customers for products and therefore our arrangement with the user is not exclusive Olimex assumes no liability for applications assistance customer product design software performance or infringement of patents or services described herein THERE IS NO WARRANTY FOR THE DESIGN MATERIALS AND THE COMPONENTS USED TO CREATE OLIN
27. it 17 07 12 P y Es Added info about fuse programmin 18 07 12 prog 8 4 Added links to all indexes 20 07 12 40 Added info about USB SERIAL CABLE 48 Fixed about the power supplies E 9 wrong powering information fixed 9 22 23 37 24 07 12 22 23 wrong power supply information fixed 37 Reset fixed 3 4 Edited the index 10 Added info about ArchLinux 12 09 12 33 Added link to a cheat sheet 42 Updated the schematic Page 44 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual Changes Modified Page 29 Fixed error about GPIO connectors G 46 Added info about a random hang up problem caused by 17 29 46 47 47 Link updates 14 Added short redirection info about Arch H Linux setup 10 12 28 UEXT connection important info added 14 28 32 32 Fixed error in pinout table PIN 29 from CON1 is GND 18 19 20 Fixed wrong info about the 18 19 20 29 10 12 LQFP128 package of iMX233 JJ 10 Wrong picture and description of the fuse 10 04 01 12 burning algorithm 9 2 Board revision Notable Changes Initial release of the board causing memory lock ups Removed termination R17 120R after first batch of boards which was Important note about owners of revision B of the board if you are one of the first owners of iMX233 OLinuXino Micro and you experience random hang ups Kernel oops Kernel panic it is recom
28. lass gpio gpio65 value sleep 1 done We save it as as gpio and we make it executable with chmod x gpio then we execut the script with gpio The LED should start blinking with 0 5Hz 2 9 How to setup Arch Linux distribution You can refer to the manual of OLinuXino MA XI for general build instructions but mind we haven t tested the algorithm listed there on the MICRO There shouldn t be significant differences Page 13 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual If you meet such head over to the OLIMEX forums 2 10 How setup the I2C SPI UART Good place to check if you are trying to configure the I2C SPI UART etc via Linux is http www inf furb br maw asm51 Telit GE863 PRO3 Linux SW UserGuide r5 pdf Telit have explained how to do it with their board but it follows the same pattern for OLinuXino Another way to test I2C is using the i2c tools utility which is available in OpenEmbedded For SPI you can use spidev tool Git link click check the spidev_test c code for an example Page 14 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual CHAPTER 3 OLINUXINO BOARD DESCRIPTION 3 Introduction to the chapter Here you get acquainted with the main parts of the board Note the names used on the board might differ from the names used below to describe them For the actual names check the OLinuXino board itself The top and the bottom view can be viewed on the next two pages of the manual There
29. ld be around 0 06A before initializing all the peripherals If you have successfully booted and powered the board the green LED1 will start blinking you have to put a SD card with Linux image in the SD card holder Page 21 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual Page 22 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual CHAPTER 6 CONNECTORS AND PINOUT 6 Introduction to the chapter In this chapter are presented the connectors that can be found on the board all together with their pinout and notes about them Jumpers functions are described Notes and info on specific peripherals are presented Notes regarding the interfaces are given 6 1 Debugging interfaces If you don t have a separate monitor or display around and you don t wish to swap cables constantly with your personal computer using the debug interfaces provide better option for you OLinuXino experience Debug UART or SJTAG en 9 There are three debugging options available on the OLinuXino It is preferable to use one of the first two UART or SJTAG but in case you want to use the classic 6 wire parallel JTAG there is an option explained below Page 23 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 6 1 1 UART debug The first one is a debug UART interface U DEBUG You can use our USB SERIAL CABLE for debugging via the UART In order to avoid SD card malfunction when using the USB SERIAL CABLE F with
30. ltages ESD shock etc If the board has warranty label it should be not broken Broken labels void the warranty same applies for boards modified by the customer for instance soldering additional components or removing components such boards will be not be a subject of our warranty If you are positive that the problem is due to manufacturing defect or component you can return the board back to us for inspection When we receive the board we will check and if the problem is caused due to our fault and we will repair replace the faulty hardware free of charge otherwise we can quote price of the repair Note that all shippings back and forth have to be covered by the customer Before you ship anything back you need to ask for RMA When you ship back please attach to it your shipping address phone e mail RMA and brief description of the problem All boards should be sent back in antistatic package and well packed to prevent damages during the transport Page 47 of 47
31. mended to unsolder remove R17 check the schematic or the board file to locate it easier Removing R17 fixes the random lock up This problem has been fixed in revision B1 of the board Page 45 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 9 3 Useful web links and purchase codes The web page you can visit for more info on your device is http www olimex com dev imx233 olinuxino maxi html and https www olimex com wiki IM X233 The forum for general questions and FAQ https www olimex com forum You can get the latest updates on the software at https github com OLIMEX OLINUXINO The OLinuXino Linux images sources https github com Freescale fsl community bsp platform ORDER CODES iMX233 OLinuXino MICRO tiny in size tiny in price and perfect for breadbording iMX233 OLinuXino MINI the mini version of the single board computer iMX233 OLinuXino MAXI the best version of OLinuXino featuring Ethernet controllert iMX233 OLinuXino MINI WIFT the MINI version of OLinuXino embedded RTL8128CU WIFI module iMX233 OLinuXino SD SD card with the Linux image which can be used with every board from the OLinuXino family MOD WIFI RTL8188 external USB WIFI modem with RTL8188 chip USB SERIAL CABLE USB serial console cable for U DEBUG SY0612E power supply adapter 12V 0 5A for iMX233 OLinuXino MICRO and iMX233 OLinuXino MINI Will not work with OLinuXino MICRO SY0605E power supply adapter 5V 1A for iMX233 OLinuXino M
32. n Chip ROM ROM aliased through 0xC0000000 1 Gbyte 0x80100000 Default Slave 0x800FFFFF Peripheral Space 128 Kbytes 0x80000000 Ox7FFFFFFF Default Slave 0x60000000 Ox5FFFFFFF External DRAM 32767 Aliases of 32 Kbytes On Chip SRAM 0x00008000 0x00007FFF On Chip SRAM 32 Kbytes 0x00000000 Page 40 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual CHAPTER 8 SCHEMATICS 8 Introduction to the chapter In this chapter are located the schematics describing logically and physically OLinuXino 8 1 Eagle schematic OLinuXino schematic is visible for reference here You can also find them on the web page for OLinuXino at our site http www olimex com dev imx233 OLinuXino micro html They are located in HARDWARE section The EAGLE schematic is situated on the next page for quicker reference Page 41 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual DCDC bo g 22uE 6 3V 1 1 1 1 Mi E FE WEN 1 3221776 3 PINS LCD 005 5 ZuFI6 3V 3d xp cp 31 mop Rid 53 Od ioci 6 3 106 vonwRAD
33. n boot the operating system from different locations The default location for the Linux files we used is the microSD card There are 4 four jumpers responsible for the boot location D03 D02 D01 and DOO They are located on the top of the board between the processor and 40pin GPIO connector Note that the jumpers are SMD type and opening a jumper would require cutting closing a jumper would require soldering To be able to do the quoted operations you will need basic engineering skills and experience You can check below the table or the schematic for the correct positions Value of 1 means the jumper is closed Start up waits for JTAG 1 1 debugger connection 6 11 Jumper description Please note that all the jumpers on the board are SMD type If you feel insecure of your soldering cutting technique it is better not to try to adjust the jumpers 6 11 1 SCL SW SCL HW and SDA SW SDA HW Those two jumpers must be moved together there are two available options configuring software I2C interface both 5 SW 5 SW closed or hardware I2C interface both SCL HW SDA HW closed The default position is SCL SW SDA SW closed soldered Page 35 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 6 11 2 5V E The 5V E jumper allows control over the powering line If you want to disable the 5V powering line open 5V_E jumper The default position is closed 6 11 3 3 3 E jumper 3 3V E jumper is open by default If
34. nitial power up it is safe to use the reset button Workaround 2 You will need a Shottky diode The Shottky should be soldered on the USB SERIAL CABLE F TX line wire RED cable with anode towards the board When you power the board by battery you have to press the PWR BUT to start the board If you start Linux and it is already running no matter which powering method you use PWR_JACK or BAT pressing the BUT will put the Linux in power save mode For the European customers we sell a power supply adapter 5V 1A SYO605E 2 5 Prebuilt software Note that the boards arrive without Linux or SD card The Linux image can be purchased separately on a SD card or you can built and adjust it yourself Page 9 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual When we program the boards we change the default position of the following HW fuses of the processor SD_MBR_BOOT 3 Blown SD_POWER_GATE_GPIO 21 20 10 PWM3 For burning the fuse position we use the BitBurner software This operation is discussed in details before Proceed with great caution when burning fuses since it is irreversible operation The first batches of the board and the SD card used the Debian Linux image After that we switched over to ArchLinux for the ease of the package manager Instructions how to build the ArchLinux can be found at the gitHub address of OLinuXino 2 6 Using BitBurner IMPORTANT MODIFYING THE FUSES IS IRREVERS
35. or number and does NOT represent the naming on the bottom of the board The table is divided into two big columns and explains the pin of both the connectors CON1 and CON2 There are three color sections in the table below Each color represents signals needed to establish a specific connection and functionality like in the MAXI and the MINI versions of the board The GREEN section CON2 Pin 3 to Pin 11 marks the signals needed to make UEXT check the schematics of OLinuXino MAXI or OLinuXino MINI or the UEXT section above for further help The YELLOW section CON2 Pin 12 to Pin 15 marks the signals needed to build SJTAG The BLUE section CON2 Pin 16 to Pin 21 shows the signals needed for audio in and audio out Page 29 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual qe e NS E menm _ e wasa wasa oi menm PiNS LCD 027 D07 BE A Par maoa sp fie s oe maa Dmmenes __ pedem e Page 30 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual manos fei fee eee eser vie ue o ___ de fee mj E The hardware is associated differently in the Linux following the GPIO naming conventions suggested in the iMX233 datasheet You can check the connection between Linux naming of the pin Olimex naming of the pin
36. pto key Boot mode specification of NAND characteristics for device that the customer is soldering to the board This means no more costly delays waiting for new device support in t he boot ROM Fully software programmable and accessible m Flexible I O Pins All digital pins have drive strength controls Most non EMI digital pins have general purpose input output GPIO mode For comprehensive information on the microcontroller visit the Freescale s web page for a datasheet At the moment of writing the microcontroller datasheet can be found at the following link http www freescale com files dsp doc ref manual IMX23RM pdf Page 20 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual CHAPTER 5 CONTROL CIRCUITY S Introduction to the chapter Here you can find information about reset circuit and quartz crystals locations the power supply circuit is discussed 5 1 Reset OLinuXino s reset circuit includes R9 47K R10 47 Q T1 T2 Q1 and a RESET button The RESET is specific for the fact that it is accomplished when the quartz is disconnected using 3 3V and the transistors T1 and T2 a AM ze mi fe ee Reset Circuit M li 5 2 Clock 24 MHz quartz crystal Q1 is connected to pins 121 and 122 of the iMX233 processor 5 3 Power supply circuit The board is powered by 5V supply and all measures listed below are taken at 5V external supply If measuring the current consumption it shou
37. pushing and NOT by pulling the card directly this can damage both the connector and the microSD card Page 27 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual 6 3 UEXT connector OLIMEX offers board extensions which can be connected via UEXT interface OLinuXino MICRO board lacks UEXT connector but it can be formed using the signals on the CON2 pad line You can check which signals you need in the CON1 and CON2 chapter For more information on UEXT please visit http www olimex com dev OTHER UEXT pdf Note the two jumpers PIN29 SOFT_CL PIN22 LCD_EN I2C_SCL and PIN28 SOFT_SDA3 PIN21 LCD_HSYNC I2C_SDA which by default are set to a software I2C They can be used to set the whole UEXT to a hardware I2C Note that the correct way of connecting modules to the UEXT is 1 Plug module to host board via UEXT 2 Power host board If you first power the board and then establish the UEXT it is possible host board restarting to occur due to the fact that some modules have large capacitors on the power line Page 28 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual UEXT connector 30 35 98 105 112 118 1 TXD Eamus peers euism sj 6 4 CON2 pads The GPIO pins led out to CON1 CON2 pads situated on the both sides of the board They allow the user to attach additional hardware check readings or perform hardware debug The Pin column shows connect
38. the board for your convenience 6 1 3 Classic JTAG debug The third option is to use the classic 6 pin parallel JTAG not including GND and VCC There are pads left for this option at the bottom of the board under the SD card holder They are named individually and framed near a name The important thing is that these pins are multiplexed with the SD card signals In order to use the 6 pin JTAG you will have to stop using the SD card Note also that the classic JTAG interface comes without plastic header mounted so in order to use it you will need to use wires for connection Consider the the software settings required to switch from SJTAG to 6 pin JTAG and vice verse referring to the iMX233 manual For instance The HW DIGCTL CTRL USE SERIAL JTAG bit in the digital control block selects whether the serial JTAG interface or the alternative six wire parallel JTAG interface is used HW DIGCTL CTRL USE SERIAL JTAG 0x0 Selects whether the one wire serial interface or the alternative six wire parallel JTAG interface is used 0 Parallel six wire JT AG is enabled and is mapped to a collection of module pins that must be enabled by programming their MUXSEL bits in the pin control block 1 Serial JTAG is enabled and uses the dedicated DEBUG The ROM bootcode writes this field prior to enabling JTAG selecting which type of JTAG pin signaling to use OLD JTAG 0x0 Use six wire parallel JTAG mode SERIAL JTAG 0x
39. ts gadget fans and also professionals since its low cost makes it very good solution for application orientated embedded systems The main usage of the board is software embedded development without the urge of understanding perfectly the hardware Page 6 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual The strong points of the boards are the processor speed the mobility of the board and the low price Customers have full access to the technical documentation of the board The software is released under General Purpose License and the board is considered open hardware 1 3 Organization Each section in this document covers a separate topic organized as follow Chapter 1 is an overview of the board usage and features Chapter 2 provides a guide for quickly setting up the board and software notes Chapter 3 contains the general board diagram and layout Chapter 4 describes the component that is the heart of the board the iMX233 microcontroller Chapter 5 is an explanation of the control circuitry associated with the microcontroller to reset Also shows the clocks on the board Chapter 6 covers the connector pinout peripherals and jumper description Chapter 7 shows the memory map Chapter 8 provides the schematics Chapter 9 contains the revision history useful links and support information Page 7 of 47 OLIMEXO 2012 OLinuXino MICRO User s Manual CHAPTER 2 SETTING UP THE OLINUXINO BOARD 2 Introduction to the chapter T
40. ty bsp fsl community bsp repo init u https github com Freescale fsl community bsp platform b denzil fsl community bsp repo sync 4 You can change the settings for the build if you want at fsl community bsp build conf local conf I changed the machine name to imx233 olinuxino maxi For Linux kernel configurations and settings you can do of course you can use also the default settings fsl community bsp setup environment build fsl community bsp build bitbake linux imx c menuconfig Check the image below File Edit View Terminal Help Linux Kernel Configuration Arrow keys navigate the menu Enter selects submenus gt Highlighted letters are hotkeys Pressing Y includes N excludes M modularizes features Press lt Esc gt lt Esc gt to exit for Help lt gt for Search Legend built in 1 excluded M module lt gt Enable loadable module support Enable the block layer gt System Type gt Bus support Kernel Features gt Boot options gt CPU Power Management gt Floating point emulation Userspace binary formats r lt Exit gt lt Help gt 5 Now to start building the image fsl community bsp setup environment build fsl community bsp build bitbake core image minimal Note on different Linux distributions you might have different tools installed and you will probably need to install depen
Download Pdf Manuals
Related Search
iMX233 OLinuXino MICRO
Related Contents
XOR 50ccm TTESNG - User Manual Sunix PAR5008T Franke Pilatus PowerStream mode operatoire de la saisie de prelevements Solac CE 4411 Boiler Replacement Internet Security 2015 - User Guide TruVision Analog PTZ Camera Installation Manual Copyright © All rights reserved.
Failed to retrieve file