ArmadeusWiki - User contributions [en]

OPOS93 SP

2025-09-23T12:59:12Z

FabienM:

[[Category: OPOS93_SP]]
[[Category:MainBoards]]
[[Category:Hardware]]
[[Category:Efinix]]
[[Category:Trion]]
[[Category:FPGA]]

== Description ==

[https://www.opossom.com/english/product-opos93sp/index.html OPOS93SP] is a SoM derivated from [https://www.opossom.com/english/product-opos93sp/index.html OPOS93] with a FPGA [https://www.efinixinc.com/shop/t20.php Trion T20] produced by Efinix.

=== FPGA ===

* [[OPOS93_SP_Interfaces_description | Interface description]]

OPOS93 SP

2025-09-23T12:57:40Z

FabienM: /* FPGA */

== Description ==

[https://www.opossom.com/english/product-opos93sp/index.html OPOS93SP] is a SoM derivated from [https://www.opossom.com/english/product-opos93sp/index.html OPOS93] with a FPGA [https://www.efinixinc.com/shop/t20.php Trion T20] produced by Efinix.

=== FPGA ===

* [[OPOS93_SP_Interfaces_description | Interface description]]

OPOS93 SP

2025-09-23T12:57:27Z

FabienM: Created page with "== Description == [https://www.opossom.com/english/product-opos93sp/index.html OPOS93SP] is a SoM derivated from [https://www.opossom.com/english/product-opos93sp/index.html OPOS93] with a FPGA [https://www.efinixinc.com/shop/t20.php Trion T20] produced by Efinix. === FPGA === * Trion T20"

Hardware

2025-09-23T12:47:25Z

FabienM: /* Baseboards */

==Armadeus Boards==
The following boards are developed by [http://www.armadeus.com Armadeus Systems]. Members of the Armadeus Project association can purchase these products at discount prices. Take a look at the [[Association]] page for details.

{| border="0" cellpadding="5" cellspacing="5" summary="Hardware Add-Ons by functionnalities"
|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"
| width="50%" |
=== APFxx and OPOSxx Systems on Module (SoM) ===
* [[APF9328]]: i.MXL based module
* [[APF27]]: i.MX27 based module with Spartan3 FPGA
* [[APF51]]: i.MX51 based module with Spartan6 FPGA
* [[APF28]]: i.MX28 based module
* [[APF6]]: i.MX6 based module
* [[APF6_SP]] : i.MX6 based module with CycloneV FPGA
* [[OPOS6UL]] : i.MX6UL based module
* [[OPOS6UL_NANO]] : i.MX6UL based nano module
* [[OPOS6UL_SP]] : i.MX6ULL based module with a Spartan6 FPGA
* [[OPOS93]]: i.MX93 based module
* [[OPOS93_SP]]: i.MX93 based module with a Trion FPGA
* [[Footprints]] : Footprint available for APFxx module
||

=== Baseboards ===
* [[OPOS93SPDev]]: full featured development board for the OPOS93_SP
* [[OPOS93Dev]]: full featured development board for the OPOS93
* [[OPOS6ULDev used with an OPOS6UL_NANO]]: full featured development board of the [[OPOS6UL]], but used with an [[OPOS6UL_NANO]] SOM (needs a SODIMM adapter
* [[OPOS6ULDev]]: full featured development board for the [[OPOS6UL]]
* No more available:
** [[APF9328DevLight]]: low cost development board for the APF9328
** [[APF9328DevFull]]: full featured development board for the APF9328
** [[APF6Dev]]: full featured development board for the APF6
** [[APF28Dev]]: full featured development board for the APF28
** [[APF51Dev]]: full featured development board for the APF51
** [[APF27Dev]]: full featured development board for the APF27 (with several options)
** [[APF27 PPS]]/PPS: network applications development board for the APF27
** [[PPS51]]: network applications development board for the APF51
|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"
| width="50%" |

=== Extension Boards ===
* [[Chimei_LW700|LW700AT_Adapt]]: Adapter for the Chimei LW700 TFT LCD
* [[Wireless_extension_board|APW wireless board]]: Add WiFi & Bluetooth & GPS & GSM to your [[APF27Dev]]
* [[SP_VISION]]: Extension with Spartan6 FPGA, for video processing
* No more available:
** [[LQ043_Adapt]]: Adapter for the Sharp LQ043 TFT LCD
** [[MTF-T035|MTF-T035_Adapt]]: Adapter for the Microtips MTF-T035 TFT LCD

||

=== Demo Boards ===
* [[HMS Demo]]: industrial demo platform
|}

==Tools==
* [http://kicad-pcb.org/ Kicad EDA tool]

Hardware

2025-09-23T12:46:13Z

FabienM: /* Baseboards */

==Armadeus Boards==
The following boards are developed by [http://www.armadeus.com Armadeus Systems]. Members of the Armadeus Project association can purchase these products at discount prices. Take a look at the [[Association]] page for details.

{| border="0" cellpadding="5" cellspacing="5" summary="Hardware Add-Ons by functionnalities"
|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"
| width="50%" |
=== APFxx and OPOSxx Systems on Module (SoM) ===
* [[APF9328]]: i.MXL based module
* [[APF27]]: i.MX27 based module with Spartan3 FPGA
* [[APF51]]: i.MX51 based module with Spartan6 FPGA
* [[APF28]]: i.MX28 based module
* [[APF6]]: i.MX6 based module
* [[APF6_SP]] : i.MX6 based module with CycloneV FPGA
* [[OPOS6UL]] : i.MX6UL based module
* [[OPOS6UL_NANO]] : i.MX6UL based nano module
* [[OPOS6UL_SP]] : i.MX6ULL based module with a Spartan6 FPGA
* [[OPOS93]]: i.MX93 based module
* [[OPOS93_SP]]: i.MX93 based module with a Trion FPGA
* [[Footprints]] : Footprint available for APFxx module
||

=== Baseboards ===
* [[OPOS6ULDev used with an OPOS6UL_NANO]]: full featured development board of the [[OPOS6UL]], but used with an [[OPOS6UL_NANO]] SOM (needs a SODIMM adapter
* [[OPOS6ULDev]]: full featured development board for the [[OPOS6UL]]
* No more available:
** [[APF9328DevLight]]: low cost development board for the APF9328
** [[APF9328DevFull]]: full featured development board for the APF9328
** [[APF6Dev]]: full featured development board for the APF6
** [[APF28Dev]]: full featured development board for the APF28
** [[APF51Dev]]: full featured development board for the APF51
** [[APF27Dev]]: full featured development board for the APF27 (with several options)
** [[APF27 PPS]]/PPS: network applications development board for the APF27
** [[PPS51]]: network applications development board for the APF51
|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"
| width="50%" |

=== Extension Boards ===
* [[Chimei_LW700|LW700AT_Adapt]]: Adapter for the Chimei LW700 TFT LCD
* [[Wireless_extension_board|APW wireless board]]: Add WiFi & Bluetooth & GPS & GSM to your [[APF27Dev]]
* [[SP_VISION]]: Extension with Spartan6 FPGA, for video processing
* No more available:
** [[LQ043_Adapt]]: Adapter for the Sharp LQ043 TFT LCD
** [[MTF-T035|MTF-T035_Adapt]]: Adapter for the Microtips MTF-T035 TFT LCD

||

=== Demo Boards ===
* [[HMS Demo]]: industrial demo platform
|}

==Tools==
* [http://kicad-pcb.org/ Kicad EDA tool]

Hardware

2025-08-25T08:32:18Z

FabienM: /* APFxx and OPOSxx Systems on Module (SoM) */

==Armadeus Boards==
The following boards are developed by [http://www.armadeus.com Armadeus Systems]. Members of the Armadeus Project association can purchase these products at discount prices. Take a look at the [[Association]] page for details.

{| border="0" cellpadding="5" cellspacing="5" summary="Hardware Add-Ons by functionnalities"
|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"
| width="50%" |
=== APFxx and OPOSxx Systems on Module (SoM) ===
* [[APF9328]]: i.MXL based module
* [[APF27]]: i.MX27 based module with Spartan3 FPGA
* [[APF51]]: i.MX51 based module with Spartan6 FPGA
* [[APF28]]: i.MX28 based module
* [[APF6]]: i.MX6 based module
* [[APF6_SP]] : i.MX6 based module with CycloneV FPGA
* [[OPOS6UL]] : i.MX6UL based module
* [[OPOS6UL_NANO]] : i.MX6UL based nano module
* [[OPOS6UL_SP]] : i.MX6ULL based module with a Spartan6 FPGA
* [[OPOS93]]: i.MX93 based module
* [[OPOS93_SP]]: i.MX93 based module with a Trion FPGA
* [[Footprints]] : Footprint available for APFxx module
||

=== Baseboards ===
* [[OPOS6ULDev used with an OPOS6UL_NANO]]: full featured development board of the [[OPOS6UL]], but used with an [[OPOS6UL_NANO]] SOM (needs a SODIMM adapter
* [[OPOS6ULDev]]: full featured development board for the [[OPOS6UL]]
* [[APF6Dev]]: full featured development board for the APF6
* [[APF28Dev]]: full featured development board for the APF28
* [[APF51Dev]]: full featured development board for the APF51
* [[APF27Dev]]: full featured development board for the APF27 (with several options)
* [[APF27 PPS]]/PPS: network applications development board for the APF27
* [[PPS51]]: network applications development board for the APF51
* No more available:
** [[APF9328DevLight]]: low cost development board for the APF9328
** [[APF9328DevFull]]: full featured development board for the APF9328
|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"
| width="50%" |

=== Extension Boards ===
* [[Chimei_LW700|LW700AT_Adapt]]: Adapter for the Chimei LW700 TFT LCD
* [[Wireless_extension_board|APW wireless board]]: Add WiFi & Bluetooth & GPS & GSM to your [[APF27Dev]]
* [[SP_VISION]]: Extension with Spartan6 FPGA, for video processing
* No more available:
** [[LQ043_Adapt]]: Adapter for the Sharp LQ043 TFT LCD
** [[MTF-T035|MTF-T035_Adapt]]: Adapter for the Microtips MTF-T035 TFT LCD

||

=== Demo Boards ===
* [[HMS Demo]]: industrial demo platform
|}

==Tools==
* [http://kicad-pcb.org/ Kicad EDA tool]

OPOS93

2025-08-25T08:29:01Z

FabienM: /* Description */

[[Category: OPOS93]]

{{Under_Construction}}

==Description==

The [https://www.opossom.com/english/product-opos93/index.html OPOS93] is a high-end [https://en.wikipedia.org/wiki/Single-board_computer Single Board Computer] targeted for advanced GUI, intensive AI computation and extended connectivity.

OPOS93

2025-08-25T08:28:51Z

FabienM: Created page with "Category: OPOS93 {{Under_Construction}} ==Description== The[https://www.opossom.com/english/product-opos93/index.html OPOS93] is a high-end [https://en.wikipedia.org/wiki/Single-board_computer Single Board Computer] targeted for advanced GUI, intensive AI computation and extended connectivity."

[[Category: OPOS93]]

{{Under_Construction}}

==Description==

The[https://www.opossom.com/english/product-opos93/index.html OPOS93] is a high-end [https://en.wikipedia.org/wiki/Single-board_computer Single Board Computer] targeted for advanced GUI, intensive AI computation and extended connectivity.

OPOS93 SP Interfaces description

2025-04-10T06:09:10Z

FabienM:

[[Category: OPOS93_SP]]
[[Category: FPGA]]

{{Under_Construction}}

[[Using_FPGA| << FPGA general page]]

OPOS6UL SP Interfaces description

2025-04-10T06:09:00Z

FabienM: /* Links */

[[Category: OPOS6UL_SP]]
[[Category: FPGA]]
[[Category: Spartan6]]
[[Category: ISE]]
[[Category: XILINX]]

== Introduction ==

This article describe the bus interface communication between the i.MX6UL(L) and the spartan6. In i.MX6UL(L) the bus used to make communication with the FPGA is named '''EIM''' for '''E'''xternal '''I'''nterface '''M'''odule. All description of this bus can be found under the i.MX6UL(L) [https://www.nxp.com/webapp/Download?colCode=IMX6ULRM reference manual] in chapter 21 (page 821).

FPGA used on board is an '''XC6SLX9-2CSG225'''.

== Simplified view ==

[[File:OPOS6UL_SP_EIM_FPGA_INTERFACE.png|600px|center|thumb|'''figure 1''' - ''i.MX6UL(L)-Spartan6 bus description'']]

Normal communication between i.MX6UL(L) processor and Spartan6 fpga is done with black following signals :

* '''EIM_BCLK''' : Clock
* '''EIM_DA[15:0]''': 16bits data and address bus
* '''EIM_LBA (ADV)''': Signal used for data/address muxing
* '''EIM_RW''': Read/Write control signal
* '''EIM_CS0''': Chip select

Gray following signals can be used by EIM (External Interface Memory), but not used in default configuration :

* '''EIM_EB0''': Select byte 0 on bus
* '''EIM_EB1''': Select byte 1 on bus
* '''OE''' : Output enable
* '''EIM_CLK0''': second clock (EIM_ACLK)

Blue following signals are used for FPGA configuration from imx. Some EIM (black) signals are also used for it.

* '''FPGA_INITB''': Initialize FPGA
* '''FPGA_PROGRAM''' : Program (configure) FPGA
* '''FPGA_DONE''': FPGA configuration is done.

== Tutorials ==

* [[opos6ul_sp_fpga_simple_howto | Simple tutorial to make communication]]
== Default configuration on CSx ==

=== Clocks ===

The clock used to clock the FPGA is EIM_BCLK (IO_L1P_CCLK_2(N12) and IO_L29P_GCLK3_2(N8)) and is configured to '''99 MHz'''.

=== Chip Select ===

The EIM memory space is mapped into 128 MB total memory space in the processor
memory. This memory space begin at address '''0x50000000'''.

{| class="wikitable"
! scope="col"| Start address
! scope="col"| End address
! scope="col"| Size
! scope="col"| Name
|-
! scope="row"| 0x5000_0000
| 0x57FF_FFFF
| 128 MB
| EIM (NOR/SRAM)
|}

The total 128 MB of memory can be divided among the EIM four chip selects. See reference manual of i.MX6ULL for more information.

=== Timings ===

==== Read ====

* U-Boot: To read one 16 bits value in 0 (0x50000000 in i.MX) do :
<pre class="apf">
BIOS> md.w 50000000 1
</pre>

* Linux: To read one 16 bits value in 0 (0x50000000 in i.MX) do :
<pre class="apf">
# devmem 0x50000000 16
</pre>
* Bus timings are following :

<wavedrom>
{ signal: [
{ name: "BCLK", wave: "P......" },
{ name: "DA", wave: "x34...x", data: "addr data", node:"..c...d." },
{ name: "ADV", wave: "101...."},
{ name: "RW", wave: "0......"},
{ name: "CS0", wave: "1.0...1"},
{ node:"..a...b." }
],
edge: ['a<-|->b RWSC=4', 'c-a', 'd-b']
}
</wavedrom>

==== Write ====

* U-Boot: To write one 16 bits value in 0 (0x50000000 in i.MX) do :
<pre class="apf">
BIOS> mw.w 50000000 CAFE
</pre>

* Linux: To write one 16 bits value in 0 (0x50000000 in i.MX) do :
<pre class="apf">
# devmem 0x50000000 16 0xCAFE
</pre>
* Bus timings are following :

<wavedrom>
{ signal: [
{ name: "BCLK", wave: "P......" },
{ name: "DA", wave: "x34...x", data: "addr data", node:"..c...d." },
{ name: "ADV", wave: "101...."},
{ name: "RW", wave: "0.1...0"},
{ name: "CS0", wave: "1.0...1"},
{ node:"..a...b." }
],
edge: ['a<-|->b WWSC=4', 'c-a', 'd-b']
}
</wavedrom>

== code & mapping ==
=== Pinout ===

Schematics interfaces is given here :

[[File:Opos6ul_sp_sch_int.jpg]]

UCF example for interface generated by [https://github.com/Martoni/periphondemand POD] is given here :

<pre>
NET "rstgen_syscon00_ext_clk" LOC="N8" | IOSTANDARD=LVCMOS33; # EIM_BCLK
NET "rstgen_syscon00_ext_clk" TNM_NET = "rstgen_syscon00_ext_clk";
TIMESPEC "TS_rstgen_syscon00_ext_clk" = PERIOD "rstgen_syscon00_ext_clk" 10.101 ns HIGH 50 %;
NET "imx6ul_wb16_wrapper00_imx_da<0>" LOC="P11" | IOSTANDARD=LVCMOS33; # EIM_DA0
NET "imx6ul_wb16_wrapper00_imx_cs_n" LOC="R11" | IOSTANDARD=LVCMOS33; # EIM_CS0
NET "imx6ul_wb16_wrapper00_imx_da<1>" LOC="M11" | IOSTANDARD=LVCMOS33; # EIM_DA1
NET "imx6ul_wb16_wrapper00_imx_da<2>" LOC="N11" | IOSTANDARD=LVCMOS33; # EIM_DA2
NET "imx6ul_wb16_wrapper00_imx_da<10>" LOC="R10" | IOSTANDARD=LVCMOS33; # EIM_DA10
NET "imx6ul_wb16_wrapper00_imx_da<11>" LOC="L9" | IOSTANDARD=LVCMOS33; # EIM_DA11
NET "imx6ul_wb16_wrapper00_imx_da<12>" LOC="M10" | IOSTANDARD=LVCMOS33; # EIM_DA12
NET "imx6ul_wb16_wrapper00_imx_da<13>" LOC="M8" | IOSTANDARD=LVCMOS33; # EIM_DA13
NET "imx6ul_wb16_wrapper00_imx_da<14>" LOC="K8" | IOSTANDARD=LVCMOS33; # EIM_DA14
NET "imx6ul_wb16_wrapper00_imx_da<15>" LOC="L8" | IOSTANDARD=LVCMOS33; # EIM_DA15
NET "imx6ul_wb16_wrapper00_imx_adv" LOC="R7" | IOSTANDARD=LVCMOS33; # EIM_LBA
NET "imx6ul_wb16_wrapper00_imx_da<7>" LOC="N6" | IOSTANDARD=LVCMOS33; # EIM_DA7
NET "imx6ul_wb16_wrapper00_imx_rw" LOC="R6" | IOSTANDARD=LVCMOS33; # EIM_RW
NET "imx6ul_wb16_wrapper00_imx_da<3>" LOC="P5" | IOSTANDARD=LVCMOS33; # EIM_DA3
NET "imx6ul_wb16_wrapper00_imx_da<4>" LOC="R5" | IOSTANDARD=LVCMOS33; # EIM_DA4
NET "imx6ul_wb16_wrapper00_imx_da<5>" LOC="L6" | IOSTANDARD=LVCMOS33; # EIM_DA5
NET "imx6ul_wb16_wrapper00_imx_da<6>" LOC="L5" | IOSTANDARD=LVCMOS33; # EIM_DA6
NET "imx6ul_wb16_wrapper00_imx_da<8>" LOC="M5" | IOSTANDARD=LVCMOS33; # EIM_DA8
NET "imx6ul_wb16_wrapper00_imx_da<9>" LOC="N5" | IOSTANDARD=LVCMOS33; # EIM_DA9
NET "irq_mngr00_gls_irq" LOC="P3" | IOSTANDARD=LVCMOS33; # FPGA_INITB
</pre>

=== Simulation model ===

Some simulation model has been written to test eim in VHDL and in python with cocotb.

==== VHDL ====

imx_read and imx_write simulation fonctions are included in POD (Peripheral On Demand) library. Available in [https://github.com/Martoni/pod_lib/blob/master/platforms/opos6ulsp/simulation/opos6ul_test_pkg.vhd platform/opos6ulsp] directory.

==== Cocotb ====

It's possible to simulate eim access with [https://cocotb.readthedocs.io/en/latest/introduction.html cocotb] module named [https://github.com/Martoni/cocotbext-imxeim cocotbext-imxeim].

=== HDL bus wrapper ===

Bus wrapper has been written in VHDL and chisel to convert EIM protocol to Wishbone bus protocol.

==== VHDL ====

A 16 bits multiplexed EIM to 16bits wishbone master bus is available in [https://github.com/Martoni/periphondemand POD] library. The VHDL sources are available following [https://github.com/Martoni/pod_lib/blob/master/library/wrappers/imx6ul_wb16_wrapper/hdl/imx6ul_wb16_wrapper.vhd this link].

==== Chisel ====

A chisel package is available in module [https://github.com/Martoni/ChisArmadeus chisArmadeus] to drive Wishbone master bus with EIM bus [https://github.com/Martoni/ChisArmadeus/blob/master/src/main/scala/chisarmadeus/op6sp/op6sp.scala here].

=== FPGA Interrupt ===

To generate an IRQ from the FPGA to the i.MX, the pin FPGA_INITB is used by default. It correspond to [[GPIOlib#Datasheet_GPIO_number_correspondance | GPIO4_IO16]] on i.MX.

=== FPGA J2 connector mapping ===

Mapping of FPGA pin is given in following [[op6spJ2pinout | csv file]].

== FPGA configuration protocol ==

<TODO>

== Links ==

* [https://www.nxp.com/docs/en/reference-manual/IMX6ULLRM.pdf i.MX6UL(L) reference manual] (PDF chapter 21 page 821)
* [https://www.nxp.com/docs/en/data-sheet/IMX6ULLIEC.pdf i.MX6UL(L) Datasheet] (PDF)
* [https://www.xilinx.com/support/documentation/user_guides/ug380.pdf Spartan6 configuration] (PDF)
* [https://github.com/Martoni/pod_lib/tree/master/platforms/opos6ulsp Peripheral On Demand configuration files]

[[Using_FPGA| << FPGA general page]]

OPOS93 SP Interfaces description

2025-04-10T06:08:40Z

FabienM: Created page with "Category: OPOS93_SP Category: FPGA {{Under_Construction}}"

[[Category: OPOS93_SP]]
[[Category: FPGA]]

{{Under_Construction}}

Using FPGA

2025-04-09T13:23:08Z

FabienM: /* Developing on the APF FPGA */

[[Category: FPGA]]
__NOTOC__

==Developing on the APF FPGA==

{| border="0" cellpadding="5" cellspacing="5" summary="Hardware Add-Ons by functionalities" width="100%"
|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"

| width="50%" |

=== FPGA Interfaces ===

* '''APF9328''': [[IMX9328-Spartan3 interface description]]
* '''APF27''': [[IMX27-Spartan3A interface description]]
* '''APF51''': [[IMX51-Spartan6 interface description]]
* '''APF6_SP''': [[APF6_SP Interfaces description]]
* '''OPOS6UL_SP''': [[OPOS6UL_SP Interfaces description]]
* '''OPOS93_SP''': [[OPOS93_SP Interfaces description]]

| width="50%" |

===Using Armadeus FPGA===
Manage the FPGA from Armadeus distribution.

* Configure the FPGA [[FPGA_loader | from Linux]], [[Target_Software_Installation#FPGA_firmware_test | from U-Boot]], [[PCIe_fpga_load | from PCIe]].
* Flashing FPGA firmware [[Uboot_FPGA_firmware_update_from_Linux | from Linux]], [[Target_Software_Installation#FPGA_firmware_installation | from U-Boot]]
* [[FPGA_register | Access the FPGA address domain from Linux]]

|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"
| width="50%" |

=== Make some examples ===

These examples give the basis to make VHDL design for FPGA.

* [[Simple blinking LED | LED]]
* [[A simple design with Wishbone bus | Complete example with button and led on wishbone bus communication and Linux drivers]]

| width="50%" |

=== Design Tools===
Description of tools used to simulate, to synthesize, and to download/configure FGPA.

'''Xilinx'''
* [[ISE WebPack and Vivado]]

'''Altera'''
* [[Quartus | Quartus Prime (Altera/Intel's free devt tool)]]
* [[Modelsim-Altera | Install Modelsim-Altera (starter edition)]]

'''Lattice'''

* [[IceCube | Install IceCube]]
* [[Diamond | Install Lattice Diamond]]

'''Microsemi'''
* [http://www.fabienm.eu/flf/installing-libero-on-debian-9/ Install Libero]

|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"

| width="50%" |

=== Automatize FPGA design making ===

==== [[Peripherals On Demand]] ====
For complex projects, POD should be used to simplify design.

==== [[FuseSoC]] ====
FuseSoC is a builder written in Python used to automatize FPGA constructions

==== CactusII ====

[http://funbase.cs.tut.fi/ Graphical IDE] for managing FPGA/ASIC design with IPX-ACT standard.

| width="50%" |

=== HDL ===

===VHDL ===

* [[VHDL coding styles|VHDL coding styles & externals documentations]]
* [http://www.xess.com/design_examples.php#XESS_Examples Nice ideas/examples to look at]
* [http://www.opencores.org www.opencores.org]
* [http://www.gmvhdl.com/VHDL.html An Introductory VHDL Tutorial]

=== Verilog ===

* [https://www.veripool.org/wiki/verilator Verilator] an High speed verilog simulator
* [http://iverilog.icarus.com/ Icarus] Famous open-source verilog simulator
* [https://symbiyosys.readthedocs.io/en/latest/ SymbiYosys] open-source Verilog formal verification

=== Synthesizable Synchronous HDL ===
==== [[Migen]] ====

With migen, it's possible to develop FPGA design in Python then generate Verilog for synthezis.

==== [[Chisel]] ====
With Chisel, it's possible to develop FPGA design in Scala then generate C++ model for simulation and Verilog model for synthesis. Armadeus system can help you to integrate a Chisel project on Armadeus board.

==== [[SpinalHDL]] ====

[https://github.com/SpinalHDL/SpinalHDL Another HDL generator] (VHDL) written in Scala.

|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"

| width="50%" |

===Links===
Some useful links.

''' Wishbone '''
* [http://cdn.opencores.org/downloads/wbspec_b3.pdf official Wishbone specifications]
* [http://en.wikipedia.org/wiki/Wishbone_%28computer_bus%29 Wikipedia Wishbone doc]

''' Spartan '''
* [http://www.xilinx.com/support/documentation/data_sheets/ds099.pdf Spartan-3 FPGA Family Data Sheet]

''' CycloneV'''
* [https://www.altera.com/products/fpga/cyclone-series/cyclone-v/overview.html CycloneV overview from altera]

''' OpenSource '''

* [http://www.fabienm.eu/flf/wp-content/uploads/2017/05/fpgamap-1.svg OpenSource FPGA map]

| width="50%" |

|}

Using FPGA

2025-04-09T13:16:48Z

FabienM: /* FPGA Interfaces */

[[Category: FPGA]]
__NOTOC__

==Developing on the APF FPGA==

{| border="0" cellpadding="5" cellspacing="5" summary="Hardware Add-Ons by functionalities" width="100%"
|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"

| width="50%" |

=== FPGA Interfaces ===

* '''APF9328''': [[IMX9328-Spartan3 interface description]]
* '''APF27''': [[IMX27-Spartan3A interface description]]
* '''APF51''': [[IMX51-Spartan6 interface description]]
* '''APF6_SP''': [[APF6_SP Interfaces description]]
* '''OPOS6UL_SP''': [[OPOS6UL_SP Interfaces description]]
* '''OPOS93_SP'': [[OPOS93_SP Interfaces description]]

| width="50%" |

===Using Armadeus FPGA===
Manage the FPGA from Armadeus distribution.

* Configure the FPGA [[FPGA_loader | from Linux]], [[Target_Software_Installation#FPGA_firmware_test | from U-Boot]], [[PCIe_fpga_load | from PCIe]].
* Flashing FPGA firmware [[Uboot_FPGA_firmware_update_from_Linux | from Linux]], [[Target_Software_Installation#FPGA_firmware_installation | from U-Boot]]
* [[FPGA_register | Access the FPGA address domain from Linux]]

|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"
| width="50%" |

=== Make some examples ===

These examples give the basis to make VHDL design for FPGA.

* [[Simple blinking LED | LED]]
* [[A simple design with Wishbone bus | Complete example with button and led on wishbone bus communication and Linux drivers]]

| width="50%" |

=== Design Tools===
Description of tools used to simulate, to synthesize, and to download/configure FGPA.

'''Xilinx'''
* [[ISE WebPack and Vivado]]

'''Altera'''
* [[Quartus | Quartus Prime (Altera/Intel's free devt tool)]]
* [[Modelsim-Altera | Install Modelsim-Altera (starter edition)]]

'''Lattice'''

* [[IceCube | Install IceCube]]
* [[Diamond | Install Lattice Diamond]]

'''Microsemi'''
* [http://www.fabienm.eu/flf/installing-libero-on-debian-9/ Install Libero]

|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"

| width="50%" |

=== Automatize FPGA design making ===

==== [[Peripherals On Demand]] ====
For complex projects, POD should be used to simplify design.

==== [[FuseSoC]] ====
FuseSoC is a builder written in Python used to automatize FPGA constructions

==== CactusII ====

[http://funbase.cs.tut.fi/ Graphical IDE] for managing FPGA/ASIC design with IPX-ACT standard.

| width="50%" |

=== HDL ===

===VHDL ===

* [[VHDL coding styles|VHDL coding styles & externals documentations]]
* [http://www.xess.com/design_examples.php#XESS_Examples Nice ideas/examples to look at]
* [http://www.opencores.org www.opencores.org]
* [http://www.gmvhdl.com/VHDL.html An Introductory VHDL Tutorial]

=== Verilog ===

* [https://www.veripool.org/wiki/verilator Verilator] an High speed verilog simulator
* [http://iverilog.icarus.com/ Icarus] Famous open-source verilog simulator
* [https://symbiyosys.readthedocs.io/en/latest/ SymbiYosys] open-source Verilog formal verification

=== Synthesizable Synchronous HDL ===
==== [[Migen]] ====

With migen, it's possible to develop FPGA design in Python then generate Verilog for synthezis.

==== [[Chisel]] ====
With Chisel, it's possible to develop FPGA design in Scala then generate C++ model for simulation and Verilog model for synthesis. Armadeus system can help you to integrate a Chisel project on Armadeus board.

==== [[SpinalHDL]] ====

[https://github.com/SpinalHDL/SpinalHDL Another HDL generator] (VHDL) written in Scala.

|----------------
|- style="background:#f4f4f4; color:black; -moz-border-radius:18px;"

| width="50%" |

===Links===
Some useful links.

''' Wishbone '''
* [http://cdn.opencores.org/downloads/wbspec_b3.pdf official Wishbone specifications]
* [http://en.wikipedia.org/wiki/Wishbone_%28computer_bus%29 Wikipedia Wishbone doc]

''' Spartan '''
* [http://www.xilinx.com/support/documentation/data_sheets/ds099.pdf Spartan-3 FPGA Family Data Sheet]

''' CycloneV'''
* [https://www.altera.com/products/fpga/cyclone-series/cyclone-v/overview.html CycloneV overview from altera]

''' OpenSource '''

* [http://www.fabienm.eu/flf/wp-content/uploads/2017/05/fpgamap-1.svg OpenSource FPGA map]

| width="50%" |

|}

Armadeus 3

2022-06-30T12:12:18Z

FabienM: /* How-to obtain the Armadeus 3 */

This page will help you use the Armadeus 3.x software release. It also provides you with information about changes compared to the previous 2.x versions of Armadeus.

==Introduction==

Armadeus 3 adds many new features, including the following:

*Some architectural changes to support different hardware targets: [[APF9328]] and [[APF27]]
*New versions of U-Boot (1.3.4), Linux kernel (2.6.27), GCC (4.2.1), Busybox (1.12.1) and also a recent version of Buildroot
*New naming convention of files
*New Flash partition mapping on the target
*TBC

==Important Information regarding documentation==

{{Note|With the introduction of the Armadeus 3 SDK, the Wiki documentation has moved to support the new software. Nevertheless you can download the following HTML dump to have the Armadeus 2.x compatible documentation: [http://www.armadeus.com/assos_downloads/wiki/wiki_assoc_html_dump_03_12_2008.tar.gz Armadeus 2.x wiki]. Wiki will also moved in the next weeks so to have an always Armadeus 3.x compatible HTML dump [http://www.armadeus.com/assos_downloads/wiki/wiki_assoc_html_dump_02_03_2009.tar.gz it's here]
}}

To summarize the documentation changes, here are the rules to adapt the documentation according to your target and version of Armadeus.
* First Armadeus configuration once you have downloaded the Armadeus package found somewhere in First Setup pages:
: Armadeus 3 first command to use according to your <board> (apf9328 or apf27): make <board>_defconfig
: Armadeus 2 first command for apf9328: make

* Binary files location according to your <board> (apf9328 or apf27):
: Armadeus 3 is buildroot/binaries/<board>/
: Armadeus 2 was buildroot/armadeus/

* Armadeus 3 binary files naming convention according to your <board> (apf9328 or apf27):
: <board>-u-boot.brec
: <board>-u-boot.bin
: <board>-linux.bin
: <board>-rootfs.arm.jffs2
: <board>-rootfs.arm.tar

* Armadeus 2 binary files naming convention for apf9328 only:
: u-boot.brec
: u-boot.bin
: linux-kernel-2.6.xx.x-arm.bin
: rootfs.arm.jffs2
: rootfs.arm.tar

* Non configurable users-space tools including compiler for your board (apf9328 or apf27):
: Armadeus 3 tools for the apf9328 are located at buildroot/build_armv4t/
: Armadeus 3 tools for the apf27 are located at buildroot/build_armv5te/
: Armadeus 2 tools are located at buildroot/build_arm/

* Configurable user-space tools (Linux, rootfs, U-Boot, Busybox...) for your board (apf9328 or apf27):
: Armadeus 3 tools for the apf9328 are located at buildroot/project_build_armv4t/apf9328/
: Armadeus 3 tools for the apf27 are located at buildroot/project_build_armv5te/apf27/
: Armadeus 2 tools are located at buildroot/project_build_arm/armadeus/

* cross compilation toolchain for your board (apf9328 or apf27):
: Armadeus 3 source toolchain for the apf9328 is located at buildroot/toolchain_build_armv4t/
: Armadeus 3 source toolchain for the apf27 is located at buildroot/toolchain_build_armv5te/
: Armadeus 2 toolchain is located at buildroot/toolchain_build_arm/

Keeping these rules in mind, you are ready to use any wiki page as a guideline whatever you are working with: Armadeus 2.x or 3.

==How-to obtain the Armadeus 3==

The third generation of Armadeus is either available on the gitlab repository: https://gitlab.com/armadeus/armadeus-bsp/-/tags/release-3.4 or by download: https://gitlab.com/armadeus/armadeus-bsp/-/archive/release-3.4/armadeus-bsp-release-3.4.tar.gz

You can checkout the new version of armadeus or update your working version of armadeus. '''We strongly suggest you to checkout the new version of Armadeus because the new naming convention of files will produce a second directory structure of toolchain, projects, build and image files that could be a source of confusion.'''

* Checkout the new version:

<pre class="host">
git clone git@gitlab.com:armadeus/armadeus-bsp.git armadeus
</pre>

this commmand will download the latest version of Armadeus.

'''Remarks''': '''Do not use spaces''' in the directory name !

* Update your working version of armadeus

'''WARNING: Do not use a simple "git checkout" because some legacy buildroot patches will break your compilation!'''

<pre class="host">
cd armadeus
rm -rf buildroot/package
rm -rf buildroot/target
rm -rf buildroot/toolchain
git checkout -f
make apf9328_defconfig or make apf27_defconfig
</pre>

'''WARNING: the latest command (make <board>_defconfig ) is very important to start with an up to date configuration!'''

At any time you can cleanup the old directories built with armadeus 2:

<pre class="host">
rm -rf buildroot/binaries/armadeus
rm -rf buildroot/build_arm
rm -rf buildroot/project_build_arm
rm -rf buildroot/toolchain_build_arm
</pre>

* How-to obtain the legacy Armadeus 2 (If you're not ready to upgrade your target): Download tar.gz at https://gitlab.com/armadeus/armadeus-bsp/-/tags/release-2.x

==How-to configure and build Armadeus 3==

* After changing the directory to ''armadeus'', you have to configure Armadeus software for the APF target.

<pre class="host">
cd armadeus/
make '''apf9328_defconfig''' or make '''apf27_defconfig'''
</pre>

The '<board>_defconfig' configuration option is the first difference with the previous releases of Armadeus.
This configuration has to be done only once after a checkout or after an update from an older version Armadeus. This command configures Armadeus for the apf board then launches the regular Buildroot configuration menu:

[[Image:Menuconfig3.png]] 

* Configure Armadeus

In System configuration ---> Armadeus Device Support menu, you can check and change the quantity of RAM available on your Armadeus board. (Default value 16MB is just fine with all APF9328 boards and 64MB for the smallest apf27).

In Filesystem images --> for each type of filesystems to build you have the option to copy the binary file to secondary location like your tftp server folder (for exemple /tftpboot).

In Bootloaders --> You will find U-Boot options at the end of this menu including the option to copy U-Boot to a secondary location like /tftpboot

In Kernel --> Destination for linux kernel binaries --> You will find options to copy linux to a secondary location like /tftpboot

* Exit the configuration tool and save your configuration

* Launch the build process and enjoy a cup of coffee for the next hour

<pre class="host">
make
</pre>

The toolchain is built automatically. During this procedure, several files are downloaded from Internet. Please wait for a while.... it takes at least one hour to compile everything! 

* Enjoy the result

The generated binary files can be found in the new subdirectory ''buildroot/binaries/<board>/'':

: '''apf9328-u-boot.brec''' (apf9328 BRecord image that can be used with the bootstrap, if U-Boot is not installed or not working, see [[BootLoader]] page)
: '''<board>-u-boot.bin''' (U-Boot image file to be used with U-Boot itself, see [[BootLoader#Update_U-Boot | updating U-Boot]])
: '''<board>-linux.bin''' (Linux image to use with U-Boot, see [[Target_Software_Installation#Linux_kernel_installation | InstallLinux]])
: '''<board>-rootfs.arm.jffs2''' (FileSystem/RootFS image to use with U-Boot, see [[Target_Software_Installation#Linux_rootfs_installation | RootFS flashing]])
: '''<board>-rootfs.arm.tar''' (for an NFS/MMC RootFS, see [[Network_Configuration#Boot_from_NFS|Booting from NFS]] & [[MultiMediaCard#Booting_from_MMC.2FSD | Booting from a MMC/SD]])

 Please note the new naming convention of binary files and directories

The toolchain and project files share a new nameing convention too:
: '''buildroot/build_armv<x>t''' (contains all non configurable user-space tools)
: '''buildroot/project_build_armv<x>t/<board>''' (contains all configurable user-space tools: target filesystem, linux, busybox and u-boot...)
: '''buildroot/toolchain_build_armv<x>t''' (cross compilation toolchain)

More information is available in the [http://buildroot.uclibc.org/buildroot.html buildroot documentation]

* Prepare binary images for download

The simplest method to prepare binary files for a download to target is to copy them in the tftpboot public directory (for example /tftpboot). You can do it manually:

<pre class="host">
cp -f buildroot/binaries/<board>/* /tftpboot
</pre>

Or you can configure buildroot to copy the image files automatically as described hereabove in '''Configure Armadeus'''. 
From here we will suppose all the image files are available at the root of your tftp server

==How-to upgrade the apf9328 target==

To prepare the upgrade of the target you have to copy binary files from ''buildroot/binaries/apf9328/'' to your ''/tftpboot'' folder or make this process automatic using the command: '''make menuconfig'''. The communication with target is fully compatible with previous versions of Armadeus, as explained in [[Communicate| communicate with the target]]

===update U-Boot (on the target)===

Using the command '''printenv''' check the target IP variables:
BIOS> printenv
bootcmd=run jffsboot
bootdelay=20
...
gatewayip=192.168.0.1
netmask=255.255.255.0
ipaddr=192.168.0.10
serverip=192.168.0.2

'''ipaddr''' is the target IP address and '''serverip''' is the one of the Host PC running the tftp server. The page [[Target_Software_Installation]] will help you to set these variables.

If everything is fine you should be ready to download the new release of u-boot:

* '''Load the new U-Boot code in RAM'''

You can use the following commands to download U-boot: 
With Ethernet and a TFTP server:

BIOS> tftpboot 08000000 apf9328-u-boot.bin

dm9000 i/o: 0x15c00000, id: 0x90000a46
DM9000: running in 16 bit mode
MAC: 00:1e:ac:00:00:02
operating at 100M full duplex mode
TFTP from server 192.168.0.2; our IP address is 192.168.0.10
Filename 'apf9328-u-boot.bin'.
Load address: 0x8000000
Loading: ##################################
done
Bytes transferred = 173036 (2a3ec hex)

Or with Ethernet and a NFS server:
BIOS> nfs 08000000 ${serverip}:/nfs_path_to_buildroot/binaries/apf9328/apf9328-u-boot.bin
Or with the kermit and a serial line
BIOS> loadb 08000000
<CTRL><ALT GR>\
c
send path_to_buildroot/binaries/apf9328/apf9328-u_boot.bin
c

* '''Test the downloaded version of u-boot'''

BIOS> go 08000000

## Starting application at 0x08000000 ...

U-Boot 1.3.4 (Dec 2 2008 - 18:44:41) apf9328 patch 3.3

I2C: ready
DRAM: 16 MB
Flash: 8 MB
In: serial
Out: serial
Err: serial

Hit any key to stop autoboot: 0
BIOS>

* '''Transfer code from RAM to Flash memory'''

There is a simple U-Boot command/script to do that:
BIOS> run flash_uboot

.. done
Un-Protected 2 sectors

.. done
Erased 2 sectors
Copy to Flash... done
.. done
Protected 2 sectors
Flashing uboot succeed
BIOS>

Advanced informations can be found at the [[BootLoader]] wiki page.

* '''Reset the environment variables and reset the board'''

Note: This is important to support the new flash memory mapping. '''!! You will loose all the variables you had defined before !!'''

BIOS> run flash_reset_env

. done
Un-Protected 1 sectors

. done
Erased 1 sectors
Erasing of flash environment variables done!
BIOS>

And do not forget to reset the board by hardware or software.

BIOS> reset

U-Boot 1.3.4 (Dec 2 2008 - 18:44:41) apf9328 patch 3.3

I2C: ready
DRAM: 16 MB
Flash: 8 MB
...

===update linux and rootfs (on the target)===

* Check and set the IP variables:

BIOS> printenv
bootcmd=run jffsboot
bootdelay=20
...
gatewayip=192.168.0.1
netmask=255.255.255.0
ipaddr=192.168.0.10
serverip=192.168.0.2

'''ipaddr''' is the target IP address and '''serverip''' is the one of the Host PC running the tftp server. The page [[Target_Software_Installation]] will help you to set these variables.

You can use the '''dhcp''' command to automatically configure these variables from your DHCP server. You probably will have to adjust the '''serverip''' variable manually.

BIOS> dhcp
dm9000 i/o: 0x15c00000, id: 0x90000a46
MAC: 00:0e:32:00:00:02
operating at 100M full duplex mode
BOOTP broadcast 1
DHCP client bound to address 192.168.0.10
BIOS> setenv serverip 192.168.0.2
BIOS> saveenv

Do not forget to save your changes in FLASH, to have them available at next power up:
BIOS> saveenv

* Update Linux (still on the target)

Using the new release of U-Boot, it is quite simple to update Linux kernel and rootfs using the news scripts included in the release:

BIOS> run update_kernel

dm9000 i/o: 0x15c00000, id: 0x90000a46
DM9000: running in 16 bit mode
MAC: 00:1e:ac:00:00:02
operating at 100M full duplex mode
TFTP from server 192.168.0.2; our IP address is 192.168.0.10
Filename 'apf9328-linux.bin'.
Load address: 0x8000000
Loading: #################################################################
#################################################################
#################################################################
#################################################################
##############################################
done
Bytes transferred = 1564776 (17e068 hex)

................ done
Erased 16 sectors
Copy to Flash... done
Flashing kernel succeed

* Update rootfs (still on the target)

BIOS> run update_rootfs

dm9000 i/o: 0x15c00000, id: 0x90000a46
DM9000: running in 16 bit mode
MAC: 00:1e:ac:00:00:02
operating at 100M full duplex mode
TFTP from server 192.168.0.2; our IP address is 192.168.0.10
Filename 'apf9328-rootfs.arm.jffs2'.
Load address: 0x8000000
Loading: #################################################################
#################################################################
#################################################################
#################################################################
#################################################################
#################################################################
#################################################################
#################################################################
#################################################################
#################################################################
#################################################################
######################################################
done
Bytes transferred = 3932160 (3c0000 hex)

........................................... done
Erased 43 sectors
Copy to Flash... done
Flashing rootfs succeed
BIOS>

===update your fpga firmware (on the target)===

Please follow the standard procedure [[InstallTargetSoftware#FPGA_firmware_installation | Firmware installation]]

==How-to develop with Armadeus / customize your SDK==

Your new Armadeus 3 is running fine on the target. Now you probably would like to customize the target for your project. 
If you are a Buildroot user, the following instructions should sound familiar.

===How-to add a software package===

Use the command '''make menuconfig'''':
<pre class="host">
$ make menuconfig
</pre>

[[Image:menuconfig_package.png]]

Select your package in the menu "package", save the configuration and compile a new rootfs
<pre class="host">
$ make
</pre>

{{Note|For a given release, not all packages are tested/running. You can consult the list of the working packages [[Buildroot-20081103_integration| here]].}}

On the target, download and flash the new rootfs:
<pre class="apf">
BIOS> run update_rootfs
...
BIOS> boot
</pre>

===How-to remove a package===

Supposing you would like to remove an unwanted package from the target.
* The first step is to use the command '''make menuconfig''' to unselect this package but this command will not remove the package from the rootfs. You have to use the ''clean'' command of buildroot. In the lines hereafter replace the word <package> with the real name of your package.
<pre class="host">
$ make menuconfig
... deselect your <package>
$ make <package>-clean
$ make
</pre>
Your new rootfs is now ready to use - Enjoy

* Some packages do not support any uninstall behavior. In such a case you can rebuild your environment using the global clean command. This command requests to compile almost everything and therefore will take time.
<pre class="host">
$ make menuconfig
... deselect your <package>
$ make clean
$ make
</pre>

{{Warning|Using this method you will lose any modification you could have done directly in the directory buildroot/project_build_armvYY/apfXX/root.
Please read the chapter [[Armadeus_3#How-to_modify_root_filesystem| How-to modify root filesystem]] hereafter.}}

Your new rootfs is ready to use - Enjoy

* A faster method exists to force to rebuild rootfs. You can delete the root directory. Unfortunately some libraries (ie c++ lib) are not reinstalled using this method.
<pre class="host">
$ make menuconfig
... deselect your <package>
$ rm -rf buildroot/project_build_armv4t/apf9328/root
$ rm -rf buildroot/project_build_armv4t/apf9328/.root
$ make
</pre>

{{Warning|Using this method you will lose any modification you could have done directly in the directory buildroot/project_build_armvYY/apfXX/root.
Please read the chapter [[Armadeus_3#How-to_modify_root_filesystem| How-to modify root filesystem]] hereafter.}}

Your new rootfs is ready to use - Enjoy

===How-to modify a software===

You would like to modify a package and test your modification on the target. The command '''make <package>-clean''' will force to rebuild the package you modified:
<pre class="host">
$ make <package>-clean
$ make
</pre>
Your new rootfs is ready to use - Enjoy

===How-to create a buildroot package===

The creation of a new buildroot package is described more in depth in the specific wiki page [[Buildroot_Packages]] and in the [http://buildroot.uclibc.org/buildroot.html buildroot documentation]

===How-to modify root filesystem===

There are different methods to modify the rootfs of the apf9328:
# modify files directly on the target (ideal solution for first trials)
# modify files in buildroot/project_build_armv4t/apf9328/root/ (to validate your modification with armadeus)
# modify files in buildroot/target/device/aramdeus/rootfs/target_skeleton (your modifcation will support a '''make clean''' )
# create a patch file in armadeus/patches (your modification will support a '''git checkout''')

===How-to modify Linux kernel===

To rebuild the kernel or any kernel driver you can use the commands:
<pre class="host">
$ make linux-clean
$ make
</pre>

your new Linux kernel and rootfs containing drivers are ready to use - Enjoy

There is another method to rebuild the kernel faster than the previous one:
<pre class="host">
$ make linux
$ make
</pre>
With this method only the modified files are compiled.

===How-to configure a Linux kernel===

There is a command to modify the linux kernel configuration:
<pre class="host">
$make linux-menuconfig
</pre>
Modify your kernel configuration, save your change and rebuild Armadeus in few seconds:
<pre class="host">
$make
</pre>

===How-to configure U-Boot===

you can change the U-Boot configuration using the buildroot command '''make menuconfig'''. U-Boot options are in the sub-menu '''target filesystem options'''. In order to rebuild U-Boot with new options it is necessary to remove U-Boot first:
<pre class="host">
$make menuconfig
...
$make u-boot-dirclean
$make
</pre>

{{Warning| the command '''make u-boot-dirclean''' delete the U-Boot directory and any modification you did in this directory.}}

===How-to modify U-Boot===

To rebuild U-Boot you can use the command '''make u-boot-clean; make'''.
<pre class="host">
$ make u-boot-clean
$ make
</pre>
your new U-Boot is ready to use - Enjoy

If you modify the config file ''apf9328.h'' located in ''buildroot/project_build_armv4t/apf9328/u-boot-1.3.4/include/configs/apf9328.h'', then we suggest you to rebuild the whole u-boot package:
<pre class="host">
$ make u-boot-distclean
$ make
</pre>

===How-to configure busybox===
It also possible to modify the Busybox configuration to add or remove some features:
<pre class="host">
$make busybox-menuconfig
</pre>

To be continued...

==Links==
* [http://buildroot.uclibc.org/buildroot.html Buildroot's documentation]

[[Category:Software]]

Template:ArmadeusNews

2022-06-30T12:06:56Z

FabienM: Undo revision 15106 by FabienM (talk)

__NOTOC__

=====June 30th, 2022: Gitlab is now official repository for armadeus bsp =====
<noinclude>
Gitlab is now official repository for armadeus bsp : https://gitlab.com/armadeus/armadeus-bsp
</noinclude>

=====August 7th, 2018: New software release [[Releases#Release_7.0_.28latest_stable_one.29|Armadeus 7.0]]=====
<noinclude>
This new [[Releases#Release_7.0_.28latest_stable_one.29| release]] introduces the support for the new [[OPOS6UL]] & [[OPOS6UL_NANO]] SoM and concludes the move to Buildroot 2017.02.</noinclude>

=====August 11th, 2015: New software release [[Releases#Release_6.0_.28latest_stable_one.29|Armadeus 6.0]]=====
<noinclude>
This new [[Releases#Release_6.0_.28latest_stable_one.29| release]] introduces the support for the new [[APF6]] & [[APF6_SP]] Armadeus modules and concludes the move to Buildroot 2015.02 and U-Boot 2014.07+. It also consolidates the support for vanilla Linux kernels (3.19+).</noinclude>

=====June 17th, 2014: Bump to [[U-Boot-2014.04| U-Boot 2014.04]]=====
<noinclude>
All Armadeus boards moved to [[U-Boot-2014.04| U-Boot 2014.04]] on [[http://sourceforge.net/p/armadeus/code/ci/master/tree/ GIT]] </noinclude>

<noinclude>
=====December 25th 2013: New software release [[Releases#Release_5.3_.28latest_stable_one.29|Armadeus 5.3]]=====
This new [[Releases#Release_5.3_.28latest_stable_one.29| release]] concludes the move to Buildroot 2013.05 and U-Boot 2013.04. It also consolidates the support for vanilla Linux kernels (3.1x).</noinclude>

<noinclude>
=====June 11th 2013: Bump to Buildroot 2013.05 on GIT [[Current_Buildroot_status_in_Armadeus]]=====
Armadeus moved to Buildroot 2013.05 on GIT. Buildroot 2013.05 will apply after the BSP is fully rebuilt, so first backup your work in progress then do: git pull; git clean -dfx; make apfxx_defconfig; make </noinclude>

<noinclude>
=====October 12th 2012: New software release [[Releases#Release_5.2_.28latest_stable_one.29|Armadeus 5.2]]=====
This new [[Releases#Release_5.2_.28latest_stable_one.29| release]] enhances the supported features on the [[APF28]] board, fix a wireless issue on the PPS board and add few other improvements to the Armadeus software</noinclude>

<noinclude>
=====August 12th 2012: Armadeus 5.0 is released=====
Consolidated support for the [[APF28]] board, BR 2012.02, U-Boot 2012.04, misc. fixes.</noinclude>

<noinclude>
=====January 27th 2012: Armadeus 4.1 is released=====
This new release adds (very preliminary & experimental) support for the [[APF28]] board, BR 2011.05, better BR integration, Linux 3.0 for APF51 and industrial automation new packages.</noinclude>

<noinclude>
=====Some members of Armadeus Project team will attend booth n°71 at LSM 2011 in Strasbourg (11 to 14th July 2011)=====
</noinclude>

<noinclude>
=====July 9th 2011: Armadeus 4.0 is released=====
This new release adds support for the [[APF51]] board, BR 2010.11 and continue integration work (experimental) of Linux 2.6.38 for APF27/PPS & APF9328.</noinclude>

<noinclude>
=====May 1rst 2011: [[APF51]] SOM and [[APF51Dev]] docking board are available=====
These new powerfull boards are available on the Armadeus Systems Online Shop.</noinclude>

<noinclude>
=====March 3rd 2011: [[Release_3.4|Armadeus 3.4]] is released=====
This new release adds support for the [[APF27_PPS]] board, and continue integration work (experimental) of BR 2010.xx & Linux 2.6.38.</noinclude>

<noinclude>
=====July 30th 2010: [[Release_3.3|Armadeus 3.3]] is released=====
This new release adds better support for the [[Wireless_extension_board|APW]], WiFi, Bluetooth, GPS, Qt 4.5.3, BR 2010.05 & U-Boot 2010.03 (experimental), etc... </noinclude>

<noinclude>
=====January 15th 2010: [[Wireless_extension_board|APW]] board is available=====
The new [[Wireless_extension_board|APW]] board ("Wireless" extension for the APF27) is available on the Armadeus Systems Online Shop.</noinclude>

<noinclude>
=====December 1rst 2009: [[Release_3.2|Armadeus 3.2]] is released=====
This new release adds better support for the [[APF27]] & 7" screen, new packages (pygame, xenomai, etc...), svn to git migration, etc... </noinclude>

<noinclude>
=====July 8th 2009: [[Current_events#General_Assembly_.2F_LSM_2009 | General Assembly / LSM 2009 ]]=====
On Wednesday July 8th 2009, occurred the General Assembly in Nantes (France) </noinclude>

<noinclude>
=====June 29th 2009: [[Armadeus 3|Armadeus software 3.1]] is released, following the [[APF27Dev|APF27DevFull]] availability=====
The new Armadeus release 3.1 supports Linux kernel 2.6.29, GDB 6.7.1, APF27 FPGA download, HDMI Output of APF27DevFull and much more.
This release can be downloaded as a tarball package from [http://sourceforge.net/project/showfiles.php?group_id=122057 the usual place]</noinclude>

<noinclude>
=====February 26th 2009: [[Armadeus 3|Armadeus software 3.0]] is released, following the [[APF27]] availability=====
The new Armadeus release 3.0 supports the new Armadeus Systems APF27 board, linux kernel 2.6.27, GCC 4.2.1, U-Boot 1.3.4 and much more.
The software released can be downloaded as a tarball package from the usual place:
http://sourceforge.net/projects/armadeus</noinclude>

<noinclude>
=====December 6th 2008: [[Armadeus 3]] software available from subversion repository=====
The third generation of armadeus software is on the track. The documentation is available at [[Armadeus 3]]. For your convenience a copy of the wiki supporting previous version of Armadeus is available for offline browsing at [http://www.armadeus.com/assos_downloads/wiki/wiki_assoc_html_dump_03_12_2008.tar.gz Armadeus 2.x wiki]</noinclude>

<noinclude>
=====20 May 2008: DevFull boards are available=====
DevFull development boards are available and will be soon sold at discount price (for Armadeus Project members) on [http://www.store.armadeus.com/index.php?language=en armadeus systems online shop]</noinclude>

<noinclude>
=====17 Dec. 2007: Armadeus software version 2.2 released!=====
Armadeus release 2.2 adds many new drivers, fixes many bugs, supports the new linux kernel 2.6.23 and a recent version of buildroot.
Armadeus 2.2 can be downloaded as a tarball package from the usual place:
http://sourceforge.net/projects/armadeus

or directly from the Subversion server (SVN):
svn co https://armadeus.svn.sourceforge.net/svnroot/armadeus/tags/release-2.2 armadeus-2.2 </noinclude>

<noinclude>
=====15 Sept. 2007: APF9328 boards have been received & first DevFull prototypes are under test=====
Now all boards are available. DevFull is working well and will be available at the end of year.</noinclude>

<noinclude>
=====10 Jun. 2007: DevLight and LCD_Adapt received, but still waiting for APF9328 :-( !=====
DevLight and LCD_Adapter boards have been received but we are now waiting for new APF9328.

=====26 Mar. 2007: DevLight and LCD_Adapt ordered !=====
A new DevLight order has been placed! Expected delivey date: week 17/18

The LCD_Adapter boards have been ordered too. Expected delivery date: week 18/19</noinclude>

<noinclude>
=====22 Mar. 2007: DevLight boards are out-of-stock !=====
We have no more DevLight boards for the moment. New one have been ordered but will only be available mid-April</noinclude>
<noinclude>
=====09 Feb. 2007: Release v2.0 is out !=====
Software Release 2.0 is (at least ;-) ) available. To download it, go on Sourceforge... Now serious things can begin ! </noinclude>
<noinclude>
=====05 Nov. 2006: APF DevLight boards received=====
New members can now join us easily.</noinclude>
<noinclude>
=====15 Oct. 2006: APF DevLight boards quite ready=====
DevLight boards are in production and will be available end of October.</noinclude>
<noinclude>
=====12 Sept. 2006: APF DevLight boards ordered=====
Nico has placed an order today for 50 APF DevLight boards. They should arrive mid-october. They will allow more people to join this project soon.</noinclude>
<noinclude>
=====10 Sept. 2006: Wiki and Web sites are quite up now=====
250 years (and some months) after the birth of Wolfgang, a new genius has come to earth: the Armadeus project... ;-)
Wiki and web site (http://www.armadeus.com) begin to rock...</noinclude>

[[Template:ArmadeusNews|Show all News]]

Template:ArmadeusNews

2022-06-30T12:06:31Z

FabienM: /* June 30th, 2022: Gitlab is now official repository for armadeus bsp */

__NOTOC__

=====June 30th, 2022: Gitlab is now official repository for armadeus bsp =====

Gitlab is now official repository for armadeus bsp : https://gitlab.com/armadeus/armadeus-bsp

=====August 7th, 2018: New software release [[Releases#Release_7.0_.28latest_stable_one.29|Armadeus 7.0]]=====
<noinclude>
This new [[Releases#Release_7.0_.28latest_stable_one.29| release]] introduces the support for the new [[OPOS6UL]] & [[OPOS6UL_NANO]] SoM and concludes the move to Buildroot 2017.02.</noinclude>

=====August 11th, 2015: New software release [[Releases#Release_6.0_.28latest_stable_one.29|Armadeus 6.0]]=====
<noinclude>
This new [[Releases#Release_6.0_.28latest_stable_one.29| release]] introduces the support for the new [[APF6]] & [[APF6_SP]] Armadeus modules and concludes the move to Buildroot 2015.02 and U-Boot 2014.07+. It also consolidates the support for vanilla Linux kernels (3.19+).</noinclude>

=====June 17th, 2014: Bump to [[U-Boot-2014.04| U-Boot 2014.04]]=====
<noinclude>
All Armadeus boards moved to [[U-Boot-2014.04| U-Boot 2014.04]] on [[http://sourceforge.net/p/armadeus/code/ci/master/tree/ GIT]] </noinclude>

<noinclude>
=====December 25th 2013: New software release [[Releases#Release_5.3_.28latest_stable_one.29|Armadeus 5.3]]=====
This new [[Releases#Release_5.3_.28latest_stable_one.29| release]] concludes the move to Buildroot 2013.05 and U-Boot 2013.04. It also consolidates the support for vanilla Linux kernels (3.1x).</noinclude>

<noinclude>
=====June 11th 2013: Bump to Buildroot 2013.05 on GIT [[Current_Buildroot_status_in_Armadeus]]=====
Armadeus moved to Buildroot 2013.05 on GIT. Buildroot 2013.05 will apply after the BSP is fully rebuilt, so first backup your work in progress then do: git pull; git clean -dfx; make apfxx_defconfig; make </noinclude>

<noinclude>
=====October 12th 2012: New software release [[Releases#Release_5.2_.28latest_stable_one.29|Armadeus 5.2]]=====
This new [[Releases#Release_5.2_.28latest_stable_one.29| release]] enhances the supported features on the [[APF28]] board, fix a wireless issue on the PPS board and add few other improvements to the Armadeus software</noinclude>

<noinclude>
=====August 12th 2012: Armadeus 5.0 is released=====
Consolidated support for the [[APF28]] board, BR 2012.02, U-Boot 2012.04, misc. fixes.</noinclude>

<noinclude>
=====January 27th 2012: Armadeus 4.1 is released=====
This new release adds (very preliminary & experimental) support for the [[APF28]] board, BR 2011.05, better BR integration, Linux 3.0 for APF51 and industrial automation new packages.</noinclude>

<noinclude>
=====Some members of Armadeus Project team will attend booth n°71 at LSM 2011 in Strasbourg (11 to 14th July 2011)=====
</noinclude>

<noinclude>
=====July 9th 2011: Armadeus 4.0 is released=====
This new release adds support for the [[APF51]] board, BR 2010.11 and continue integration work (experimental) of Linux 2.6.38 for APF27/PPS & APF9328.</noinclude>

<noinclude>
=====May 1rst 2011: [[APF51]] SOM and [[APF51Dev]] docking board are available=====
These new powerfull boards are available on the Armadeus Systems Online Shop.</noinclude>

<noinclude>
=====March 3rd 2011: [[Release_3.4|Armadeus 3.4]] is released=====
This new release adds support for the [[APF27_PPS]] board, and continue integration work (experimental) of BR 2010.xx & Linux 2.6.38.</noinclude>

<noinclude>
=====July 30th 2010: [[Release_3.3|Armadeus 3.3]] is released=====
This new release adds better support for the [[Wireless_extension_board|APW]], WiFi, Bluetooth, GPS, Qt 4.5.3, BR 2010.05 & U-Boot 2010.03 (experimental), etc... </noinclude>

<noinclude>
=====January 15th 2010: [[Wireless_extension_board|APW]] board is available=====
The new [[Wireless_extension_board|APW]] board ("Wireless" extension for the APF27) is available on the Armadeus Systems Online Shop.</noinclude>

<noinclude>
=====December 1rst 2009: [[Release_3.2|Armadeus 3.2]] is released=====
This new release adds better support for the [[APF27]] & 7" screen, new packages (pygame, xenomai, etc...), svn to git migration, etc... </noinclude>

<noinclude>
=====July 8th 2009: [[Current_events#General_Assembly_.2F_LSM_2009 | General Assembly / LSM 2009 ]]=====
On Wednesday July 8th 2009, occurred the General Assembly in Nantes (France) </noinclude>

<noinclude>
=====June 29th 2009: [[Armadeus 3|Armadeus software 3.1]] is released, following the [[APF27Dev|APF27DevFull]] availability=====
The new Armadeus release 3.1 supports Linux kernel 2.6.29, GDB 6.7.1, APF27 FPGA download, HDMI Output of APF27DevFull and much more.
This release can be downloaded as a tarball package from [http://sourceforge.net/project/showfiles.php?group_id=122057 the usual place]</noinclude>

<noinclude>
=====February 26th 2009: [[Armadeus 3|Armadeus software 3.0]] is released, following the [[APF27]] availability=====
The new Armadeus release 3.0 supports the new Armadeus Systems APF27 board, linux kernel 2.6.27, GCC 4.2.1, U-Boot 1.3.4 and much more.
The software released can be downloaded as a tarball package from the usual place:
http://sourceforge.net/projects/armadeus</noinclude>

<noinclude>
=====December 6th 2008: [[Armadeus 3]] software available from subversion repository=====
The third generation of armadeus software is on the track. The documentation is available at [[Armadeus 3]]. For your convenience a copy of the wiki supporting previous version of Armadeus is available for offline browsing at [http://www.armadeus.com/assos_downloads/wiki/wiki_assoc_html_dump_03_12_2008.tar.gz Armadeus 2.x wiki]</noinclude>

<noinclude>
=====20 May 2008: DevFull boards are available=====
DevFull development boards are available and will be soon sold at discount price (for Armadeus Project members) on [http://www.store.armadeus.com/index.php?language=en armadeus systems online shop]</noinclude>

<noinclude>
=====17 Dec. 2007: Armadeus software version 2.2 released!=====
Armadeus release 2.2 adds many new drivers, fixes many bugs, supports the new linux kernel 2.6.23 and a recent version of buildroot.
Armadeus 2.2 can be downloaded as a tarball package from the usual place:
http://sourceforge.net/projects/armadeus

or directly from the Subversion server (SVN):
svn co https://armadeus.svn.sourceforge.net/svnroot/armadeus/tags/release-2.2 armadeus-2.2 </noinclude>

<noinclude>
=====15 Sept. 2007: APF9328 boards have been received & first DevFull prototypes are under test=====
Now all boards are available. DevFull is working well and will be available at the end of year.</noinclude>

<noinclude>
=====10 Jun. 2007: DevLight and LCD_Adapt received, but still waiting for APF9328 :-( !=====
DevLight and LCD_Adapter boards have been received but we are now waiting for new APF9328.

=====26 Mar. 2007: DevLight and LCD_Adapt ordered !=====
A new DevLight order has been placed! Expected delivey date: week 17/18

The LCD_Adapter boards have been ordered too. Expected delivery date: week 18/19</noinclude>

<noinclude>
=====22 Mar. 2007: DevLight boards are out-of-stock !=====
We have no more DevLight boards for the moment. New one have been ordered but will only be available mid-April</noinclude>
<noinclude>
=====09 Feb. 2007: Release v2.0 is out !=====
Software Release 2.0 is (at least ;-) ) available. To download it, go on Sourceforge... Now serious things can begin ! </noinclude>
<noinclude>
=====05 Nov. 2006: APF DevLight boards received=====
New members can now join us easily.</noinclude>
<noinclude>
=====15 Oct. 2006: APF DevLight boards quite ready=====
DevLight boards are in production and will be available end of October.</noinclude>
<noinclude>
=====12 Sept. 2006: APF DevLight boards ordered=====
Nico has placed an order today for 50 APF DevLight boards. They should arrive mid-october. They will allow more people to join this project soon.</noinclude>
<noinclude>
=====10 Sept. 2006: Wiki and Web sites are quite up now=====
250 years (and some months) after the birth of Wolfgang, a new genius has come to earth: the Armadeus project... ;-)
Wiki and web site (http://www.armadeus.com) begin to rock...</noinclude>

[[Template:ArmadeusNews|Show all News]]

Template:ArmadeusNews

2022-06-30T12:05:55Z

FabienM:

Footprints

2022-06-30T12:03:42Z

FabienM:

To develop a custom docking board for an APFxx module, a symbol/footprint component is necessary. As Armadeus systems uses Mentor PAD to design their boards then, by default, PAD's footprint/symbol are approved for industrial designs.
Some footprint/symbol are available for others design software, they are marked '''na''' for '''n'''ot '''a'''pproved if no industrial design has been made with these footprint/symbol.

{| border="1" cellpadding="5" cellspacing="0" align="center"
|- style="background:#efefef;" align="center"
! Software >!! rowspan="2" | Mentor PAD !! rowspan="2" | Mentor PAD export !! rowspan="2" | KiCad !! rowspan="2" | Eagle
|- style="background:#efefef;" align="center"
! Module V
|- align="center"
| [[APF9328]] || not available || not available || not available || not available
|- align="center"
|
[[APF27]]
|| [https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf27/PAD/mentor_symbol_apf27.c] 
[https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf27/PAD/mentor_footprint_apf27.d]
|| [https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf27/PAD_export/mentor_export_symbol_apf27.txt] 
[https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf27/PAD_export/mentor_export_footprint_apf27.asc]
|| not available
|| not available
|- align="center"
|
[[APF51]]
|| [https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf51/PAD/mentor_symbol_apf51.c] 
[https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf51/PAD/mentor_footprint_apf51.d]
|| [https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf51/PAD_export/mentor_export_symbol_apf51.txt] 
[https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf51/PAD_expert/mentor_export_footprint_apf51.asc]
|| not available
|| not available
|- align="center"
| [[APF28]]
|| [https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf28/PAD/mentor_symbol_apf28.c] 
[https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf28/PAD/mentor_footprint_apf28.d]
|| [https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf28/PAD_export/mentor_export_symbol_apf28.txt] 
[https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf28/PAD_export/mentor_export_footprint_apf28.asc]
|| [https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf28/kicad/kicad_symbol_apf28.lib] 
[https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf28/kicad/kicad_symbol_apf28.kicad_mod]
|| not available
|- align="center"
| [[APF6]]
|| [https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf6/PAD/apf6.p] 
[https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf6/PAD/apf6.d]
|| [https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf6/PAD_export/apf6.txt] 
[https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/apf6/PAD_export/footprint.asc]
|| not available
|| not available
|- align="center"
| [[APF6_SP]]
|| TODO
|| TODO
|| not available
|| not available
|- align="center"
| [[OPOS6UL]]
|| TODO
|| TODO
|| [https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/opos6ul/kicad/opos6ul.lib)] 
[https://gitlab.com/armadeus/armadeus-bsp/-/tree/master/hardware/opos6ul/kicad/Opos6ul_Socket_SODIMM_DDR3_TE_2013289.kicad_mod]
|| not available
|- align="center"
| [[OPOS6UL_NANO]]
|| TODO
|| TODO
|| TODO
|| not available
|- align="center"
| [[OPOS6UL_SP]]
|| TODO
|| TODO
|| TODO
|| not available
|}

All Symbols/Footprint described in this table can be found in [[Toolchain#Get_Armadeus_software | Armadeus gitlab repository]] in '''hardware''' directory.

APF6 legacy Linux 4.1 kernel status

2022-06-30T11:50:05Z

FabienM:

[[Category: kernel]]
[[Category: APF6]]
The [[APF6]] Linux distribution can be found here: [https://gitlab.com/armadeus/armadeus-bsp/-/tags latest stable installation tarball from gitlab]

==Current version==
Currently (armadeus-6.0) default supported Linux version for APF6 is: '''vanilla 3.19'''. Details about this kernel can be found [[APF6_Linux_kernel_status|here]].

We also support "legacy" kernels, based on Freescale/Wandboard's versions, to have GPU/VPU functionalities available until integrated in vanilla/mainline. This page detail the Freescale 4.1.xxx Linux version support.

Details concerning the drivers usage can be found [[Setup|below]].

* NT = Not Tested
* NA = Not Available / Not possible

==APF6 module==

{| border="1" cellpadding="5" cellspacing="0" summary="Functionnalities test results"
|----------------
| colspan="5" align="center" style="background:#b9e9a3;" | '''4.1.15_2.0.0_ga legacy'''
|- style="background:#efefef;"
! '''Driver''' || colspan="2" | '''Compiling ? Static / Module''' || ''' Working ? ''' || '''Comments'''
|----------------
|'''eMMC''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK ||
|----------------
|'''SPI''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || [[SPI]] / Not tested yet.
|----------------
|'''I2C''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[I2C]]
|----------------
|'''Keypad''' || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || Not tested yet
|----------------
|'''MMC/SD/SDIO''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK ||
|----------------
|'''UART''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK ||
|----------------
|'''Ethernet''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK ||
|----------------
|'''USB OTG''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[USB]]
|----------------
|'''USB HOST1''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[USB]]
|----------------
|'''PWM''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[PWM]]
|----------------
|'''RTC''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || i.MX6 internal [[RTC]]
|----------------
|'''Watchdog''' || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || [[Watchdog]]
|----------------
|'''PM sleep/wakeup''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || [[Power management]]
|----------------
|'''Frequency scaling''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || Not tested yet
|----------------
|'''CSI (Camera)''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || Tested with a wandcam and SDL capture demo.
|----------------
|'''SSI (Audio)''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[ALSA]]
|----------------
|'''Video codec (H.263/4)''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || H.264 with [[Gstreamer]]
|----------------
|'''3D GPU''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || OpenGLES 2.0
|----------------
|'''Security/Sahara/RTIC''' || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || Not tested yet
|----------------
|'''Wi-Fi (b/g)''' || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || [[Wifi]] - [[Wl12xx_driver]]
|----------------
|'''Bluetooth''' || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || [[Bluetooth]] / No RTS/CTS Bluetooth
|----------------
|'''FPGA POD interface''' || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || Not tested yet
|----------------
|'''FPGA loading''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || Only available on APF6SP
|----------------
|'''Xenomai''' || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT
|----------------
|}

==APF6Dev development baseboard==
* NT = Not Tested
* NA = Not Available / Not possible

{| border="1" cellpadding="5" cellspacing="0" summary="Functionnalities test results"
|----------------
| colspan="5" align="center" style="background:#b9e9a3;" | '''4.1.15_2.0.0_ga legacy'''
|- style="background:#efefef;"
! '''Driver''' || colspan="2" | '''Compiling ? Static / Module''' || '''Working ?''' || '''Comments'''
|----------------
|'''SATA''' || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT ||
|----------------
|'''PCIe''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT ||
|----------------
|'''microSD''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK ||
|----------------
|'''Ethernet''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:orange;" | ~OK || 100M only at the moment
|----------------
|'''LCD''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || Tested with LW700. [[LCD]]
|----------------
|'''Backlight''' || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || Not tested yet
|----------------
|'''Headphone audio Out''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[ALSA]]
|----------------
|'''SPDIF Optical audio Out''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[ALSA]] be sure to force SPDIF output with: aplay -D "default:CARD=imxspdif" /usr/share/sounds/alsa/Side_Left.wav
|----------------
|'''HDMI audio Out''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[ALSA]]
|----------------
|'''MIC audio In''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[ALSA]]
|----------------
|'''Touchscreen''' || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || Single touch only.
|----------------
|'''USB Host 1''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || High Speed
|----------------
|'''CAN Bus''' || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || [[CAN_bus_Linux_driver]]
|----------------
|'''HDMI''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || Issues with some DVI monitor.
|----------------
|'''GPS''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || [[GPS]]
|----------------
|'''GSM / 3G''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || [[Gsm]]
|----------------
|'''GPIO''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[GPIOlib]]
|----------------
|'''User LED''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[GPIO LEDS]]
|----------------
|'''User button''' || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || style="background:#00ff00;" | OK || [[GPIO keys]]
|----------------
|'''RTC MCP79400''' || style="background:#00ff00;" | NT || style="background:#00ff00;" | OK || style="background:#eeee00;" | NT || [[RTC]]. Timekeeping only.
|}

APF27 Linux kernel status

2022-06-30T11:49:34Z

FabienM:

See [[Kernel-upstream-status]] for fresh information about APF27 kernel status.

The APF27 Linux distribution can be found here: [https://gitlab.com/armadeus/armadeus-bsp/-/tags latest stable installation tarball from gitlab]

==Current version==
Currently (Armadeus-6.0) supported Linux version is: '''2.6.29.6'''.
Details concerning the drivers usage can be found [[Setup|here]].

* NT = Not Tested
* NA = Not Available / Not possible

==APF27 module (ie i.MX27 internal controllers + FPGA)==

{| border="1" cellpadding="5" cellspacing="0" summary="Functionnalities test results"
|----------------
| colspan="5" align="center" style="background:#b9e9a3;" | '''2.6.29.6'''
|----------------
! '''Driver''' || colspan="2" | '''Compiling ? Static / Module''' || ''' Working ? ''' || '''Comments'''
|----------------
|'''NAND Flash''' || style="background:#00ff00;" | OK || NA || style="background:#00ff00;" |OK ||
|----------------
|'''PCMCIA''' || NA || NA || NA || can not be used on the APF27
|----------------
|'''1Wire''' || style="background:#eeee00;" |NT || style="background:#eeee00;" |NT || style="background:#eeee00;" |NT || not integrated yet
|----------------
|'''ATA''' || NA || NA || NA || can not be used on the APF27
|----------------
|'''SPI''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK ||

|----------------
|'''I2C''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK ||

|----------------
|'''Keypad''' || style="background:#eeee00;" |NT || style="background:#eeee00;" |NT || style="background:#eeee00;" |NT || not integrated yet

|----------------
|'''MMC/SD/SDIO''' || style="background:#00ff00;" | OK || NA || style="background:#00ff00;" | OK ||

|----------------
|'''UART''' || style="background:#00ff00;" | OK || NA || style="background:#00ff00;" | OK ||

|----------------
|'''Ethernet''' || style="background:#00ff00;" | OK || NA || style="background:#00ff00;" | OK ||

|----------------
|'''USB OTG''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || Used as High Speed Host only (for the moment == on APF27Dev)

|----------------
|'''USB HOST1''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK ||

|----------------
|'''USB HOST2''' || NA || style="background:#eeee00;" |NT || style="background:#eeee00;" |NT ||

|----------------
|'''PWM''' || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK ||

|----------------
|'''RTC''' || style="background:#eeee00;" |NT || style="background:#eeee00;" |NT || style="background:#eeee00;" |NT || internal RTC
|----------------
|'''Watchdog''' || style="background:#eeee00;" |NT || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || i.MX27 internal Watchdog
|----------------
|'''CSI''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK ||

|----------------
|'''GPIO''' || style="background:#00ff00;" | OK || NA || style="background:#f6b400;" | Partially || GPIOlib work but no interrupts with /sys/class/gpio/gpioX/edge file

|----------------
|'''LCD''' || style="background:#00ff00;" | OK || NA || style="background:#00ff00;" | OK ||

|----------------
|'''SSI (Audio)''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK ||

|----------------
|'''Video codec (H.263/4)''' || NA || style="background:#eeee00;" |NT || style="background:#eeee00;" |NT || Only encoding was validated. Mostly relies on userspace tools.

|----------------
|'''Security/Sahara/RTIC''' || style="background:#eeee00;" |NT || style="background:#eeee00;" |NT || style="background:#eeee00;" |NT ||

|----------------
|'''FPGA POD interface''' || NA || style="background:#00ff00;" | OK|| style="background:#00ff00;" | OK || Wishbone bus

|----------------
|'''FPGA loading''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK ||

|----------------
|}

==APF27Dev development baseboard==
* NT = Not Tested
* NA = Not Available / Not possible

{| border="1" cellpadding="5" cellspacing="0" summary="Functionnalities test results"
| colspan="5" align="center" style="background:#b9e9a3;" | '''2.6.29.6'''
|- style="background:#efefef;"
! '''Driver''' || colspan="2" | '''Compiling ? Static / Module''' || ''' Working ? ''' || '''Comments'''
|----------------
|'''RTC''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" |OK || [[RTC|DS1374]]

|----------------
|'''microSD''' || NA || style="background:#00ff00;" | OK|| style="background:#00ff00;" | OK ||

|----------------
|'''Ethernet''' || style="background:#00ff00;" | OK || NA || style="background:#00ff00;" | OK ||

|----------------
|'''RS232''' || style="background:#00ff00;" | OK || NA || style="background:#00ff00;" | OK ||

|----------------
|'''LCD''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK ||

|----------------
|'''Audio out''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || [[ALSA]]
|----------------
|'''Audio in''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK ||

|----------------
|'''Touchscreen''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || [[TSC2102_Linux_driver]]

|----------------
|'''USB Host High Speed''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK ||

|----------------
|'''USB Host Full Speed''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK ||

|----------------
|'''ADC''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || MAX1027

|----------------
|'''DAC''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || MAX5821

|----------------
|'''CAN Bus''' || NA || style="background:#eeee00;" |NT|| style="background:#eeee00;" | NT || MCP2515

|----------------
|'''HDMI''' || colspan="2" | No drivers needed || style="background:#00ff00;" | OK || [[DVI_/_HDMI|AD9889]]

|----------------
|'''GPS''' || colspan="2" | No drivers needed || style="background:#00ff00;" | OK || [[Wireless extension board]]

|----------------
|'''GSM''' || colspan="2" | No drivers needed || style="background:#00ff00;" | OK || [[Wireless extension board]]

|----------------
|'''Wi-Fi''' || NA || style="background:#00ff00;" | OK || style="background:#00ff00;" | OK || [[Wireless extension board]]

|----------------
|'''Bluetooth''' || NA || style="background:#eeee00;" | NT || style="background:#eeee00;" | NT || [[Wireless extension board]]

|----------------
|}

[[Category: kernel]]

Quilt

2022-06-30T11:44:44Z

FabienM:

== Introduction ==
Quilt is a little tool used to manage patches. The project is hosted on [http://savannah.nongnu.org/projects/quilt savannah forge] and can be found in debian package repository.

== Using quilt in Armadeus project ==

Quilt is useful when linux kernel or buildroot modification must be done. Because Armadeus use official linux/buildroot sources, each specific modification for our platform must be done with a patch. And patches are versionned on Armadeus gitlab repository in directory buildroot/target/device/armadeus/linux/kernel-patches/ for Linux kernel and in patches/buildroot for buildroot.

=== quiltify.sh ===

To use it under Armadeus Project, a simple script was written to simplify it : ''quiltify.sh''. Launch it from the root project :

<pre class="host">
[ ] $ ./scripts/quiltify.sh
</pre>

Then answer questions (defaults are recommended). For linux kernel, quiltify will rename your source directory and download/patch/compile again the sources.

=== By Hand ===

quiltify is used when patch are stored in Armadeus standard directory. For specific projects, where patches are stored elsewhere it doesn't work. To do this, you can follow this procedure:

* linux-dirclean: linux kernel should be rebuild from ''scratch'' then first we have to cut the branch (in bsp root directory do):
<pre class="host">
$ make linux-dirclean
</pre>
* linux-extract: We have to just extract virgin linux source (don't compile yet):
<pre class="host">
$ make linux-extract
</pre>
* Once extract done, go to linux source directory and add patch one by one :
<pre class="host">
$ cd buildroot/output/build/linux-5.3-rc4/
# Import patches one by one:
$ quilt import /Path/to/personnal/kernel/patches/my_wonderful_patch.patch
# All patches from a directory:
$ quilt import /Path/to/personnal/kernel/patches/*.patch
</pre>

=== Play with quilt ===

Once you done it, you can go to linux sources directory ''buildroot/project_build_armv5te/apf27/linux-2.6.29.6'' then list all patches applied to with quilt command :
<pre class="host">
[ ] $ quilt applied
015-armadeus-logo-add_armadeus-project_tux.patch
016-armadeus-imxfb-add_platform_specific_init_exit_functions.patch
018-armadeus-i2c-imx-add_driver_to_linux_build_system.patch
…
336-armadeus-imxfb-makes_it_compatible_with_arch_imx.patch
337-armadeus-imxfb-add_lcd_clock_def_for_imx_platform.patch
338-denx-mxcgpio-emulates_interrupt_on_both_edges.patch
339-apf27-armadeus-spidev.patch
</pre>

If you want to create a new patch, just use ''new'' quilt command. Then '''before''' modifying Linux file, add it to quilt with ''add'' command.

The file can be modified according to your wish.

Once modification done, you can generate the patch using ''refresh'' command. To add yours patches in the right directory, go to your project root then launch the script with ''export'' command :
<pre class="host">
[ ] $ ./scripts/quiltify.sh export
</pre>

Your patch is now ready to be committed on Armadeus gitlab.

== Documentation ==

The [http://linux.die.net/man/1/quilt man page] of quilt is a good documentation, it's strongly recommended to read it before using it.

How to make a VHDL design in Ubuntu/Debian

2022-06-30T10:44:55Z

FabienM:

[[Category: FPGA]]

This tutorial describes how to install all the necessary tools to develop simple designs under Ubuntu for the Armadeus Project. 
As Ubuntu is a Debian based distribution, all the informations on this page should work with Debian too.

== Editing VHDL ==

To edit VHDL code all standard editing softwares like Vim, Emacs or others can be used.
But Emacs has a really good [http://www.iis.ee.ethz.ch/~zimmi/emacs/vhdl-mode.html vhdl-mode] used by lots of designers. If you hate Emacs, you
can use the xilinx-embedded editor or vim with a [http://code.google.com/p/vim-vhdl/ VHDL-plugin] under development.

== Making a simple project ==

It's a good idea to make a clean project tree for your design, because different software are
used and each generates a large amount of files.

Here is an example of a VHDL project tree :

* '''MySimple_project/'''
**'''src/''' for all sources files (.vhd,.ucf,.xcf)
**'''testbench/''' VHDL sources files for testing your design
**'''ise/''' Xilinx web pack will work in this directory
**'''simu/''' All files generated by the simulator

== Simulation ==
To stay in the Free Software spirit, the best method to simulate is to use [http://ghdl.free.fr/ GHDL] (based on GCC). 
To install it on Ubuntu you just have to type :
$ sudo apt-get install ghdl

You can find a good tutorial for using GHDL [http://forum.ubuntu-fr.org/viewtopic.php?pid=1545563#p839075 here] and on [http://ghdl.free.fr/ghdl/Starting-with-GHDL.html#Starting-with-GHDL the official website]. It's supposed that the project tree
used is this one described previously.

Analysing files:
$ ghdl -i --ieee=synopsys --warn-no-vital-generic --workdir=simu --work=work src/*.vhdl testbench/testb_file.vhd
And compile:
$ ghdl -m --ieee=synopsys --warn-no-vital-generic --workdir=simu --work=work testb_file

After that a binary file named ''testb_file'' is created; to launch simulation we just have to:
$ ./testb_file --stop-time=500ns --vcdgz=testb_file.vcdgz
The stop time option sets the simulation time and the vcdgz option will generate a gunzip compressed wave file to visualize the result.

Visualizing the result can be done with gtkwave:
$ sudo apt-get install gtkwave

We can launch it with the following command :
$ gunzip --stdout testb_file.vcdgz | gtkwave --vcd

[[Image:gtkwave.png|700px]]

It can be a good idea to make a Makefile instead of typing all this commands, here is a little Makefile:

<code lang="makefile">

# project name
PROJECT=bus_led_top
# vhdl files
FILES = src/bus_led.vhd src/bus_led_top.vhd
# testbench
SIMTOP = led_top_tb
SIMFILES = testbench/led_top_tb.vhd
# Simu break condition
GHDL_SIM_OPT = --assert-level=error
#GHDL_SIM_OPT = --stop-time=500ns

SIMDIR = simu
SYNTHFILES = bin/bus_led_ise/netgen/synthesis

GHDL_CMD = ghdl
GHDL_FLAGS = --ieee=synopsys --warn-no-vital-generic

VIEW_CMD = /usr/bin/gtkwave

ghdl-compile :
mkdir -p simu
$(GHDL_CMD) -i $(GHDL_FLAGS) --workdir=simu --work=work $(SIMFILES) $(FILES)
$(GHDL_CMD) -m $(GHDL_FLAGS) --workdir=simu --work=work $(SIMTOP)
@mv $(SIMTOP) simu/$(SIMTOP)

ghdl-run :
@$(SIMDIR)/$(SIMTOP) $(GHDL_SIM_OPT) --vcdgz=$(SIMDIR)/$(SIMTOP).vcdgz

ghdl-view:
gunzip --stdout $(SIMDIR)/$(SIMTOP).vcdgz | $(VIEW_CMD) --vcd

ghdl-clean :
$(GHDL_CMD) --clean --workdir=simu
</code>

to use it, just write :
$ make ghdl-compile
to compile, then:
$ make ghdl-run
to run the design, then:
$ make ghdl-view
to launch gtkwave and visualize the results.

== Syntesis, place & route ==

=== GUI installation ===
To synthesize the design it is mandatory to use Xilinx tools (It's not exactly true, others tools can be used for synthesize like Mentor tools, but at the end, to make the bitstream, Xilinx tools are mandatory), fortunately Xilinx provides his webpack for Linux. [[ISE_WebPack_installation_on_Linux| Click here if you didn't install it yet.]]

To launch the floorplanner, DISPLAY has to be change:
<pre class="host">
export DISPLAY=:0
</pre>

After this installation, ISE can be found in the directory ''$(Xilinx_root_dir)/bin/lin''.
To avoid retyping export, a little script ''launch_ise.sh'' can be made in ''bin/lin/'' directory:
<source lang="bash">
#!/bin/bash
export DISPLAY=:0
~/Xilinx92i/bin/lin/ise
</source>

Then make launch click :

[[Image:lanceurise.png]]

There is a good tutorial on [http://harded.free.fr/site/?p=31 harded.free.fr].

=== Using Xilinx command line tools for shell syntesis ===

See [http://panteltje.com/panteltje/fpga/index.html Using Xilinx Webpack-8.1i on grml Linux in scripted mode, without GUI] for an introduction.

First of all, library files has to be copied in library directory :
sudo -s
mkdir /usr/local/lib/xilinx/
cp Xilinx_directory/bin/lin/*.so /usr/local/lib/xilinx/
echo /usr/local/lib/xilinx >> /etc/ld.so.conf
ldconfig

Then modify your .bashrc (add at the end):
PLATFORM=lin
XILINX=Xilinx_directory
export XILINX
PATH=Xilinx_directory/bin/lin:$PATH
export PATH

Then ISE can be used in command line (xst, ngdbuild, map, bit,...). To avoid typing very long commands it can be a good idea to use a Makefile, xess.com provide a full [http://www.xess.com/appnotes/makefile.php Makefile] to do this and a basic Makefile for simulation and synthesis can be found in the armadeus gitlab project: [https://gitlab.com/armadeus/armadeus-bsp/-/blob/master/firmware/wishbone_example/wishbone_example9328_27/Makefile]. To use it modify the head and write the names of your files :

*General options

# project name
PROJECT=bus_led_top
# vhdl files
FILES = src/bus_led.vhd src/bus_led_top.vhd

* constraints for synthesis

# pin configuration
UCF_FILE = src/bus_led.ucf
# Synthesis constraints file
XCF_FILE =

*Testbench options

# testbench
SIMTOP = led_top_tb
SIMFILES = ../apf_pkg/apf_test_pkg.vhd testbench/led_top_tb.vhd

*Simulation can stop after a given time or after an assert error (end of test for example)

# Simu break condition
GHDL_SIM_OPT = --assert-level=error
#GHDL_SIM_OPT = --stop-time=500ns

A simple design with Wishbone bus

2022-06-30T10:43:16Z

FabienM:

[[Category: FPGA]]

This article is intended to explain how to design Wishbone compatible components with simple example.
The VHDL source code can be found in firmware/wishbone_example from [https://gitlab.com/armadeus/armadeus-bsp our gitlab repository].

Description of the Wishbone structure for Armadeus APF boards can be found [[FpgaArchitecture#Le_bus_Wishbone | here]] (in french).

== General structure ==

The main functionality of this component is to allow to switch-on a LED when a button is pressed.

When button is pressed, the component ''button'' send interrupt signal to
''irq_mngr''. ''irq_mngr'' will toggle a flag and send interruption to
'''i.MX''' processor. A Linux driver on '''i.MX''' will read ''irq_mngr'' and
acknowledge irq by writing '1' on the corresponding register. And finally, Linux driver will
toggle LED value by writing in ''led'' register.

[[image:Wb_buttonled_top.png|700px|center|thumb|'''figure 1''' - ''Schematics of wishbone example. /!\ Bus signals are wrong for the APF51 because addr and data are multiplexed.'']]

''imx_wrapper'', ''syscon'' and ''irq_mngr'' are standards
ARMadeus-Wishbone IPs that just been instantiated in our design.

''button'' and ''led'' are simple slave component we want to integrate in the FPGA.

All these components are connected together with the 'glue logic' component ''intercon''.

=== Wrapper ===
The [http://armadeus.git.sourceforge.net/git/gitweb.cgi?p=armadeus/armadeus;a=blob;f=firmware/wishbone_example/src/wishbone_wrapper.vhd;h=d23110bac06cb121677e551c9eb5efc36b9e5981;hb=HEAD wrapper] is used to convert i.MX interface signals into Wishbone signals.

=== Intercon ===

The [http://armadeus.git.sourceforge.net/git/gitweb.cgi?p=armadeus/armadeus;a=blob;f=firmware/wishbone_example/src/intercon.vhd;h=dfa98f69ee2263a715945173e138c846e186981c;hb=HEAD intercon] is a component used to manage signals between Wishbone master and slave components. This component decode Wishbone-master addresses and dispatch them to Wishbone-slave components.

[[image:Wb_intercon.png|center|500px|thumb|'''figure 2''' - ''Intercon internal structure'']]

== Wishbone slave application components ==

In this example there are 3 Wishbone-slave components :

=== irq manager ===

Some components (here, only ''button'') generate interrupts, [http://armadeus.git.sourceforge.net/git/gitweb.cgi?p=armadeus/armadeus;a=blob;f=firmware/wishbone_example/src/irq_mngr.vhd;h=014735fb81478b668091beac08af358d6c61240c;hb=HEAD irq manager] is used to mux these interrupts for i.MX. The irq_mngr can manage up to 16 internal interrupts.

IRQ manager component has tree registers, one to enable interrupts, one for flags/acknowledge interrupts and one identification register :

{| align="center" border="1" cellpadding="5" cellspacing="0" summary="irq_mgr registers"
|- style="background:#efefef;" align="center"
! register !! function
|-
| mask
| write '1' to allow irq
|-
| ack/pend
| read for pending irq, write to acknowledge irq
|-
| id
| identification register
|}

=== wb_led ===

{{Note| On apf9328_devfull and on apf27_dev a LED is already soldered on fpga. '''For apf27_dev the FPGA bank1 must be powered with 3.3V''' (connect pin 39 and pin 1 on J20 header (near Ethernet one)). For '''apf51Dev''' don't forget to power banks with jumper FPGA_Bank3 and FPGA_Bank1}}

This component is a simple 16-bit Wishbone slave output port, from [http://cdn.opencores.org/downloads/wbspec_b3.pdf wishbone specification example] (p110).

[[image:wbs_led.png|center|thumb|600px|'''figure 3''' - ''LED internal structure'']]

It is a simple register, that can be read and write. The LED is controlled with register pin 0.

The two registers are :

{| align="center" border="1" cellpadding="5" cellspacing="0" summary="wb_led registers"
|- style="background:#efefef;" align="center"
! register name !! (relative) address !! function
|-
| LED || 0x00 || Write '1' in LSB to shutdown LED
|-
| id || 0x02 || read identification number
|}

=== wb_button ===

Wb_button component, is like ''led'' but in read only and with an edge detector to rise irq.

{{Note| On [[APF27Dev]] and [[APF51Dev]] a button is already soldered to a FPGA pin. Just don't forget to power corresponding FPGA bank. For [[APF9328DevFull]] a button must be connected to IO_L01N_0 FPGA pin (connector X7/FPGA2, pin 1)}}
[[image:wbs_button.png|center|thumb|500px|'''figure 4''' - ''Button internal structure'']]

The two registers are:

{| align="center" border="1" cellpadding="5" cellspacing="0" summary="wb_button registers"
|- style="background:#efefef;" align="center"
! register !! (relative) address !! function
|-
| id || 0x00 || read identification number
|-
| Button || 0x02 || read LSB to know button state
|}

== Components drivers ==

Each component is driven by a Linux driver described above. All driver code is in armadeus directory in [http://armadeus.svn.sourceforge.net/viewvc/armadeus/trunk/target/linux/modules/fpga/wishbone_example/ target/linux/module/fpga/wishbone_example/].

Each component has an identification register with unique number. This number is used by driver when modprobed to unsure that device is present.

=== irq manager ===

The description of IRQ management module is available [[POD_Interrupt_handler | here]]. The module's source code can be found [http://armadeus.svn.sourceforge.net/viewvc/armadeus/trunk/target/linux/modules/fpga/wishbone_example/wb_irq_mngr/main.c?view=markup here].

=== LED ===

LED driver is seen in Linux like a character driver. Writing in a ''/dev'' file will enable or disable the LED.

The driver is composed of two modules :

* '''led_ocore''' : this module implement generic LED driver mechanisms.
* '''wb_example_led''' : This module describe specific datas for each LED-component available in design. These datas are described in structure ''plat_led_port'' and ''plat_led_device''. The module will register each LED with ''platform_device_register()'' function. When a ''plat_led_port'' device is registered, ''led_ocore'' driver will detect it and will probe it with ''led_probe'' function.

=== button ===

Button driver is seen in Linux like a character driver. When a process want to read value in button register, the driver will block reading until an interrupt occur.

Structure of button driver is similar to LED driver (two modules) :

* '''button_ocore''' : This module implements generic button driver mechanisms.
* '''wb_example_button''' : Like LED module, this module describes specific data for each button-component available in design.

== Using the design ==

All code for this design is available in ARMadeus tree, [http://armadeus.svn.sourceforge.net/viewvc/armadeus/trunk/firmware/wishbone_example/ firmware] (VHDL) and [http://armadeus.svn.sourceforge.net/viewvc/armadeus/trunk/target/linux/modules/fpga/wishbone_example/ software] (Linux drivers).

=== Make the FPGA bitstream ===

ISE Webpack is mandatory to generate the bitstream, so [[ISE_WebPack_installation_on_Linux | its installation is required]]. Once bitstream has been generated, it can be downloaded in FPGA with [[Target_Software_Installation#FPGA_firmware_installation | U-Boot]] or [[FPGA_loader | Linux]].
For '''apf51''', bitstream is under the directory '''firmware/wishbone_example/wishbone_example51/binaries/top_wishbone_example51_lx9.bin'''. For apf27 and apf9328 bitstream can be found in '''firmware/wishbone_example/wishbone_example9328_27/bin/'''.

=== Compile Linux drivers ===

To compile the drivers for this design select them in Linux menuconfig:
<pre class="host">
$ make linux-menuconfig
</pre>

<pre class="config">
Device Drivers --->
Armadeus specific drivers --->
FPGA Drivers --->
[*] Board designs
[*] board drivers for wishbone example
<M> board Button
<M> board Led
<M> board irq
</pre>

and compile them:
<pre class="host">
$ make linux && make
</pre>

Then reflash [[Target_Software_Installation#Linux_kernel_installation | Linux]] and [[Target_Software_Installation#rootfs_installation | rootfs]] images.

=== Play with button and LED ===

==== Load modules ====

Modules must be loaded in right order with ''modprobe'' command :

* IRQ manager :
<pre class="apf">
# modprobe irq_ocore
# modprobe wb_example_irq_mngr
</pre>
* Button generic module must be loaded before board module:
<pre class="apf">
# modprobe button_ocore
# modprobe wb_example_buttons
button button.0: BUTTON0: MAJOR: 249 MINOR: 0
BUTTON0 loaded
</pre>
* LED generic module must be loaded before board module:
<pre class="apf">
# modprobe led_ocore
# modprobe wb_example_led
LED0: MAJOR: 248 MINOR: 0
LED module LED0 insered
</pre>

==== Device access ====

Devices access are done with special caracters file. These file must be created '''with major and minor number given when modules are loaded''' (see ''Load modules'' above) :

* Make LED access :
<pre class="apf">
# mknod /dev/led0 c LED_MAJOR_NUMBER 0
</pre>
* Make button access :
<pre class="apf">
# mknod /dev/button0 c BUTTON_MAJOR_NUMBER 0
</pre>

Replace '''LED_MAJOR_NUMBER''' and '''BUTTON_MAJOR_NUMBER''' with correct major number given when modprobe is done.

==== Test LED ====

A test program is available in module directory:
<pre class="host">
target/linux/modules/fpga/board_designs/wishbone_example/wb_led/
</pre>
simply compile it with arm-linux-gcc compiler :

<pre class="host">
$ make test
</pre>

Download ''testled'' binary on your APF, then test it :
<pre class="apf">
# ./testled /dev/led0
Testing led driver
Read 1
Write 0
Read 0
Write 1
Read 1
Write 0
Read 0
</pre>

LED is blinking slowly.

==== Test Button ====

A test program is available in directory:
<pre class="host">
target/linux/modules/fpga/board_designs/wishbone_example/wb_button/
</pre>
simply compile it in the directory with command:
<pre class="host">
$ make test
</pre>

copy the ''testbutton'' binary in your target then launch it:
<pre class="apf">
# ./testbutton /dev/button0
Testing button driver
Read 1
Read 0
Read 1
Read 0
Read 1
Read 0
Read 0
Read 1
Read 0
Read 1
</pre>

Each time button is pushed or released, button state is printed out.

==== Switching LED with button ====

A simple program is available in wishbone example directory:
<pre class="host">
target/linux/modules/fpga/board_designs/wishbone_example/
</pre>
to switch on the LED when button is pressed.

To compile :
<pre class="host">
$ make test
</pre>

To use it, simply type (after downloaded it under your target):

<pre class="apf">
# ./push-led /dev/button0 /dev/led0
Blink a led pushing button
</pre>

Push the button to switch on/off the LED.

Trash Fr:Compilateur croisé

2022-06-30T10:42:19Z

FabienM: /* Récupération de l'archive Armadeus */

Comment installer le kit de développement du projet Armadeus pour Linux/Window$

{{Under_Construction}}

==Prérequis pour une installation Window$==
Pour développer des programme pour la carte Armadeus, il vous faudra installer Cygwin dans un premier temps: http://www.cygwin.com.
Choisissez une installation par défaut et ajoutez les paquets suivants en cliquant une fois sur l'icône "skip":
* devel -> subversion
* devel -> make
* devel -> patchutils
* devel -> gcc-core
* devel -> gcc-g++
* devel -> gdb
* devel -> binutils
* devel -> libncurses-devel
* devel -> gettext-devel
* devel -> bison
* devel -> flex
* system -> util-linux
* web -> wget

==Prérequis pour une installation Linux==
Vérifiez que vous avez les paquets suivants installés dans votre distribution:
* cvs (fixme)
* gettext
* libncurses
* svn
* wget
* autoconf
* zlib1g-dev
* libacl1-dev

Sous Debian, vous pouvez utiliser la commande suivante:
$ sudo apt-get install autoconf automake bison flex g++ gettext libncurses5-dev liblzo1 liblzo-dev liblzo2-2 liblzo2-dev \
patch subversion texinfo wget zlib1g-dev libacl1 libacl1-dev

Il a été rapporté que l'installation se déroule bien sur: Fedora Core 3, Fedora Core 4, Debian Sarge, Ubuntu Edgy

==Installation==

Ouvrez un shell et suivez la procédure suivante:

===Récupération de l'archive Armadeus===
* Si vous voulez la derniere version du logiciel atmadeus, récupérez les fichiers requis depuis le dépôt:
$ git clone git://git.code.sf.net/p/armadeus/code armadeus

Un répertoire appelé armadeus/ sera créé sur votre disque dur et contiendra tous les fichiers dont vous aurez besoin.
* Sinon, téléchargez l'archive d'installation depuis gitlab: https://gitlab.com/armadeus/armadeus-bsp/-/tags et décompressez la dans un répertoire avec au moins 2 Go d'espace libre.

===Configurez le générateur de distribution Armadeus :===
$ cd armadeus/
$ make menuconfig (ou juste make la première fois).
Ceci lancera la configuration du Buildroot.
Dans le menu Board Support Option, sélectionnez votre carte armadeus (apf/apm9328), la taille de la RAM (16/32MB) et ainsi de suite...
* Si vous avez besoin de la LIBSTD C++, ajoutez ceci dans le menuconfig/options du toolchain/options additionelles de gcc :
--disable-libstdcxx-pch. Ceci désactivera l'utilisation des en-êtes du précompilateur.
*Quittez l'outil de configuration en enregistrant votre config.

===Lancez le build===
$ make
La chaine de compile, le noyau linux et le système de fichier sont construits automatiquement. Durant cette procédure, plusieurs fichiers seront téléchargés depuis Internet. S'il vous plait, attendez un peu... cela prend au moins une heure la première fois!

===Problèmes:===
* <strike>crash de la compilation avec uclibc-0.9.28: lancez make à nouveau</strike> should be fixed now
* <strike>crash de la compilation avec gdb 6.3: lancez make à nouveau</strike> should be fixed now
* <strike>crash de la compilation avec linux 2.6.12: lancez make à nouveau</strike> should be fixed now

===Appréciez le résultat===
Les fichiers binaires générés se trouvent dans le sous-répertoire armadeus/buildroot/binaries/armadeus:

* '''u-boot.brec''' (peut être utilisé en mode bootstrap si U-Boot n'est pas installé ou ne marche plus. Dans ce cas regardez la page du [[BootLoader]] )
* '''u-boot.bin''' (à télécharger depuis U-Boot, regardez la page [[BootLoader]] "Update u-boot")
* '''linux-kernel-2.6.xx-arm.bin''' (à télécharger depuis U-Boot, regardez InstallLinux)
* '''rootfs.arm.jffs2''' (à télécharger depuis U-Boot, regardez InstallFileSystem?)
* '''rootfs.arm.tar''' (pour un rootfs par NFS ou sur MMC/SD, regardez RootNFS)

==Pour garder votre copie de travail à jour par rapport au dépôt Armadeus==
$ svn update
Ceci mettra à jour votre répertoire de travail à la dernière release.

Note: si "svn update" échoue à cause d'un répertoire ou fichier qui existe déjà, faites ceci:
$ rm -rf <le_répertoire/ou_le_fichier>
$ svn update

Vous pouvez faire un:
$ make defconfig
pour avoir récupérer les paramètres par défaut puis un:
$ make menuconfig
pour apporter vos modifications personnelles

Vous devez faire un '''make''' pour reconstruire les fichiers binaires et ensuite chargez les fichiers binaires sur votre cible/carte.

Note: Si finalement rien ne marche alors que ça marchait avant la dernière mise à jour,
vous pouvez appliquer la procédure suivante:
$ rm -rf buildroot
$ rm Makefile
$ svn update
$ make
$ make

Enjoy!

FPGA and led

2022-06-30T10:41:29Z

FabienM:

{{Note| This article is only for '''apf9328''' module board}}

This project is intented for people who are new to VHDL. Code for this design can be found [https://gitlab.com/armadeus/armadeus-bsp on armadeus gitlab] into firmware/leds/button_led/.

We will connect a switch and a led to the FPGA and use some VHDL code to toggle the led state each time the switch is pressed.

'''Some usefull informations:'''

The main FPGA page [http://www.armadeus.com/wiki/index.php?title=FPGA] of the armadeus wiki.

This document [http://www.cs.uml.edu/~fredm/courses/91.548-spr06/files/qst.pdf] gives a lot of usefull information on how to use ISE Webpack.

Page 9 of this document shows the devlight pinout matrix: [http://www.armadeus.com/downloads/apf9328DevLight/documentation/dataSheet_APF9328_DevLight.pdf]

Pages 28 and 29 of the APF datasheet shows the mapping of the devlight pinouts with the FPGA pinouts :[http://www.armadeus.com/downloads/apf9328/documentation/dataSheet_APF9328.pdf]

'''Schematic'''

[[Image:schema.png]]

'''Anatomy of the circuit'''

The led_top.vhd is a VHDL file where the components of the circuit are instantiated and connected between them.

The functional diagram of the circuit is :

[[Image:led_top.png]]

Benoît Canet / benoit on #armadeus
[[Category: FPGA]]

Fr:FAQ

2022-06-30T10:40:40Z

FabienM: /* Où sont les sources ? */

==Questions générales==

===Quel est le but du "projet Armadeus" ?===
Le but de ce projet est de permettre à tous de développer facilement des systèmes embarqués à base de Logiciel/matériel Libres.
"Quand tous les systèmes embarqués tourneront sur des Logiciels Libres, la vie n'en sera que meilleure ! ;-)".

===Que signifie "Armadeus" ?===
"Armadeus" est la contraction de "ARM" et "Amadeus". En effet nous avons choisi l'architecture ARM pour sa simplicité et son efficacité, et nos cartes sont aussi douées pour faire tourner des systèmes embarqués que ne l'était Mozart pour composer de la musique (:-) ). Bon, le projet Armadeus a aussi surtout vu le jour en 2006, année du 250ème anniversaire de la naissance de Mozart.

===Comment obtenir de l'aide ?===
[[Help:Contents | Page détaillant comment obtenir de l'aide]] 
Si vous habitez en France, nous avons des membres à Besançon, Montbéliard & Mulhouse qui peuvent vous aider (suivant leur temps libre). Pour les membres Suisses, ils peuvent éventuellement obtenir de l'aide à Bâle, Lausanne & Zürich. 
===Quelle est la relation entre http://www.armadeus.org et http://www.armadeus.com ? Y a t'il une société derrière l'assoc existante ?===

http://armadeus.com> est le site web dédié à la société Armadeus Systems. Elle développe et produit les cartes qui sont ensuite proposées aux membres de l'association à des tarifs réduits (usage non commercial uniquement !).

Historiquement l'association Armadeus Project a été fondée avant la société Armadeus Systems.
Après un an d'existence, nous avons vite vu que les objectifs que nous nous étions fixés ne pouvaient être atteint sans un investissement plus conséquent en temps et en moyens financiers.
C'est la raison pour laquelle la société à été fondée.

L'association a été crée par plaisir et aussi afin d'aider les particuliers et les universitaires à développer des systèmes embarqués Linux. L'association est à but non lucratif et fonctionne essentiellement grâce au temps investit par les membres fondateurs.

Les développements (hardware/firmware/software) effectués au sein de l'association sont sous licence GPL/LGPL. Les cartes electroniques financées par l'association ne peuvent être utilisées à des fins commerciales.

==Questions sur le Matériel==

===De quoi est composée la carte Armadeus APF9328 ?===
Cette carte est architecturée autour d'un [http://www.freescale.com/files/32bit/doc/ref_manual/MC9328MXLRM.pdf processeur i.MXL de chez Freescale] (ex Motorola). Ce processeur 32 bits contient un coeur ARM920T cadencé à 192Mhz et possède les périphériques intégrés suivant:
* 1 contrôleur LCD (TFT, CSTN, STN) jusqu'à 640x480 avec contrôle de rétro-éclairage
* 1 port USB 1.1 device
* 2 bus SPI
* 1 bus I2C
* 2 port séries asynchrones rapides
* 2 ports séries synchrones (SSI)
* 1 contrôleur MMC/SD (mode 4bits)
* 1 PWM (capable de générer des sons)
* 1 interface pour capteur CCD
* un mode bootstrap série (plus besoin de JTAG pour programmer le bootloader)
* un grands nombre de GPIOs (entrées/sorties), dépendant des périphériques configurés

Voici un lien pour avoir plus d'informations: [http://www.armadeus.com/downloads/apf9328/documentation/dataSheet_APF9328.pdf]

Sur notre carte l'i.MXL est associé à:
* 16Mo de SDRAM rapide (bus 32 bits)
* 16Mo de Flash NOR (bus 16 bits)
* un contrôleur 10/100Mbits Ethernet Davicom DM9000
* un FPGA Xilinx Spartan3 200k portes (optionnel)
* un CAN (SPI) et un CNA (I2C) (optionnels)
* des convertisseurs de niveau série (console), PHY USB et PHY Ethernet
* 2 connecteurs donnant accès aux signaux principaux

===Qu'est-ce que la carte APF9328DevLight ?===
Les cartes APF9328 ont été conçues pour être aussi petites que possible et être capables de s'intégrer dans n'importe quel système embarqué. Une carte APF9328 n'est donc pas utilisable seule. Considérez la plutôt comme un module processeur pouvant se connecter partout. Pour développer sur les cartes APF9328 vous pouvez soit développer votre propre "carte fille", soit utiliser celles que nous avons développées pour nos propres besoins.

Actuellement seule la carte "DevLight" est disponible en quantité. Elle contient:
* un connecteur série
* un connecteur USB
* un connecteur Ethernet
* une zone prototype de test
* un connecteur microSD
* un zone préroutée permettant de connecter un TFT (MTFT035 / LQ043)
* une alimentation régulée avec une entrée standard

Voici un lien pour avoir plus d'informations
[http://www.armadeus.com/downloads/apf9328DevLight/documentation/dataSheet_APF9328_DevLight.pdf]

===Qu'est-ce que la carte APF9328DevFull ?===
La carte "DevFull" sera la version sur-vitaminée de la DevLight. Les premiers prototypes sont en cours de validation (sortie prévue mi avril 2008). Cette carte de développement contiendra:
* un contrôleur audio + avec interface écran tactile
* un contrôleur de bus CAN (option)
* un connecteur MMC/SD
* une RTC sauvegardée par batterie (option)
* un connecteur LCD compatible avec les TFT (LQ043 / MTFT035)
* un host USB 2.0 Fullspeed (2 ports)
* une sortie vidéo (PAL/NTSC)
* une mémoire externe pour le FPGA (option)
* une alimentation à découpage 2.5A avec une plage d'entrée étendue
* de nombreux connecteurs permettant d'accèder facilement à tous les signaux de la carte

===De quel matériel ai-je besoin pour commencer à développer ?===
En plus de la carte APF9328 et d'une carte de développement (type DevLight), vous aurez besoin:
* d'une alimentation stabilisée délivrant une tension >= 5v,
* d'un cable série Null-Modem et d'un port série sur votre PC (ou d'un adaptateur USB <-> série pour certains portables),
* d'un routeur Ethernet pour monter un réseau local entre votre PC et la carte, ainsi que des cables Ethernet adequat,
* d'un cable USB, type ceux utilisés pour les imprimantes (si vous voulez utiliser la fonctionnalité USB),
* et éventuellement d'un fer à souder avec un multimètre.
* enfin un Adapteur USB/Série si vous n'avez pas de port série sur votre ordinateur (C'est souvent le cas des ordinateurs portables récents)

===Où trouver ce matériel===
* Sur des sites marchands d'électronique comme http://www.conrad.fr/ ou http://www.selectronic.fr/
* Exemples:
** Alimentation stabilisée:
***http://www.selectronic.fr/article.asp?article_ref_entier=11.1063-9999
***http://www.selectronic.fr/article.asp?article_ref_entier=10.0854-9999
** Adaptateur USB/Série:
***http://www.selectronic.fr:80/article.asp?article_ref_entier=90.8014-6
***http://www.pearl.fr/cables/cables-informatiques/usb/interface-usb-vers-1-port-serie_PX3034.html
***http://www.conrad.fr/webapps/adaptateur_serie.html
** Câble série null modem (RS232 9F/9F) croisé:
***http://www.selectronic.fr:80/article.asp?article_ref_entier=90.8502-9999

===Est ce que vos cartes sont compatibles avec la norme RoHS ?===
Oui

==Questions sur le Logiciel==

===Sur quelles briques de Logiciels Libres repose le projet ?===
* U-Boot pour le bootloader
* Linux 2.6 pour le système d'exploitation
* Buildroot pour la génération du "rootfs", avec toute sa suite logicielle
* Qt/Embedded OpenSource (Qtopia) ou SDL pour l'interface graphique
* et nos programmes à nous :-)

===Où sont les sources ?===
Notre projet est hébergé sur gitlab: https://gitlab.com/armadeus/armadeus-bsp

===Quelles sont les connaissances nécessaires pour développer ?===
* connaissances de base des systèmes Unix/Linux
* les bases en C/C++
* des notions d'électronique sont recommandées
* nous essayons de faire en sorte que toutes les explications données ne soient pas réservées aux "hackers"

===Quelles sont les performances de votre système ?===
[[Performances]]

===Au secours j'ai besoin d'aide===
[[Help:Contents]]

{{LanguageBar|FAQ|FAQ|FAQ}}

WindowsInstall

2022-06-30T10:39:58Z

FabienM:

{{Need_Update}}

How-To install Armadeus Software Development Kit for Window$

The toolchain can also be built on a windows system. To do this, VMWare(a virtualization tool) has to be installed first.

==Prerequisites for Window$ installation==


Be sure to have at least 3Go on, your hard disk before starting the installation

 
*Install VMWare workstation for evaluation: http://www.vmware.com/download/
Remark: you need to be registered to download the evaluation...

*Download an Ubuntu ISO distribution (eg: Feisty) and burn a CD
*Start VMWare and create a new virtual machine (File->New)
*Configure the virtual machine (memory space, RAM...)
*Place the Ubuntu ISO CD in the drive
*Start the virtual machine
*Once the Ubuntu desktop appears, click install
*At the end of the installation, quit Ubuntu (shutdown)
*Now you have a complete Linux OS.
Linux can be started by double clicking on the .vmx file.

As the VMWare workstation is only valid a few weeks, you will need to install the VMWare player which is free (http://www.vmware.com/download/player/).

Depending on the linux distribution you have installed, several packages have to be installed before compiling the Armadeus package.

Take a look at the [[LinuxInstall]] for the rest of the procedure.

==Cygwin user ONLY==

Choose the default installation (nothing to modify) and add the following packages by clicking one time on the "skip" icon:
* devel -> automake
* devel -> binutils
* devel -> bison
* devel -> flex
* devel -> gcc-core
* devel -> gcc-g++
* devel -> gdb
* devel -> gettext-devel
* devel -> libncurses-devel
* devel -> make
* devel -> patchutils
* devel -> subversion
* python -> python an interactive interpreter
* system -> util-linux
* web -> wget

==Installation==

Open a cygwin shell and follow this procedure:

==Get Armadeus software==
* If you are a user:
then download the installation archive from [gitlab https://gitlab.com/armadeus/armadeus-bsp/-/tags] and detar it wherever you want.
$ tar xjvf armadeusArchiveName.tar.bz2
* If you are a registered developper:
In cygwin, check out the required files from the SVN repository:
$ git clone git://git.code.sf.net/p/armadeus/code armadeus armadeus
A directory named armadeus/ will be created on your hard-disk and will contain all the files you need.

Remarks:
*The armadeus directory has to be placed within the cygwin directory
*Do not use spaces in the directory name !
*Write access are limited to the integrators

* If it is your first toolchain installation , the following script has to be executed in order to patch some cygwin files and add the required fake user for the rootfs generation
$ ./armadeus/host/patches/cygwin/run

==Configure Armadeus software==
$ cd armadeus/
$ make menuconfig (or just make the first time).
This will launch the buildroot configuration.
in Board Support Option menu, select your armadeus board (apf/apm9328), the RAM size (16/32MB) and so on...
* If you need the LIBSTD C++, add this in the menuconfig/toolchain options/additional gcc options:
--disable-libstdcxx-pch. This will disable the use of the precompiler headers
* Exit the configuration tool and save your config

==Launch build==
$ make
The toolchain is built automatically. During this procedure, several files are downloaded from the web. Please wait for a while.... it takes at least one hour for the first run!

===Known Problems===
* none for the moment :)

==Enjoy the result==
The generated binary files can be found in the subdirectory armadeus/software/buildroot:

* '''u-boot.brec''' (can be used with the bootstrap, if U-Boot is not installed or not working, see [[BootLoader]] page)
* '''u-boot.bin''' (for download with uboot, see [[BootLoader]] "Update u-boot" page)
* '''linux-kernel-2.6.xx-arm.bin''' (for download with uboot, see InstallLinux)
* '''rootfs.arm.jffs2''' (for download with uboot, see InstallFileSystem?)
* '''rootfs.arm.tar''' (for an nfsroot, see RootNFS?)

==To keep your copy up-to-date within the armadeus tree==
$ svn update
This will update your working directory to the latest release.

Note: if "svn update" fails because a directory or a file already exists, then do:
$ rm -rf <this-directory/file>
$ svn update

You can do a:
$ make defconfig
to have the latest features automatically activated and a
$ make menuconfig
to set again your personnal parameters (SDRAM size...).

You have to do a '''make''' to rebuild binary files end then upload the binary files to your target.

Note: if definitively everything goes wrong while it worked before the last update.
You can apply the following procedure:
$ make dirclean
$ rm -rf software/buildroot
$ rm Makefile
$ svn update
$ make
$ make

LinuxInstall

2022-06-30T10:38:44Z

FabienM: /* Get Armadeus software */

<noinclude>
<big>How-To install Armadeus Software Development Kit (SDK) on Linux systems. This SDK is currently based on the (excellent) [http://buildroot.net/ Buildroot].</big>
</noinclude>

The installation was successfully tested on the following distributions:
* Debian Lenny (5.0), Squeeze (6.0.x), Wheezy (7.2), Jessie (8.0)
* X/KUbuntu Edgy Eft (6.10), Gutsy Gibbon (7.10), Hardy Heron (8.04) & Jaunty Jackalope (9.04)
* Ubuntu Lucid Lynx (10.04) (32 & 64bits), 12.04 LTS (32 & 64bits), 13.10 (32 & 64bits), 14.04, 15.04 & 16.04
* LUbuntu 17.10
* Mandriva 2006
* Fedora Core 3 & 4, Fedora 10, Laughlin (14)
* Red Hat Enterprise 5.2
* Gentoo 10.0 (32 & 64 bits)
* SuSE 10.1, OpenSUSE 11.3 - 12.3

'''The installation may fail on:'''
* Ubuntu Karmic Koala (9.10): tslib fails to build

'''APF28 requirements:'''
* APF28 board requires a Linux distribution with (GNU) tar version 1.20 or later to compile the Linux Kernel - Please update or upgrade your Linux distribution.

==Prerequisites for Linux installation==
{{Note|From here we assume that your Linux system has a ''make'' version '''greater or equal to''' 3.81. To check it:
<pre class="host">
$ make -v
GNU Make 3.81
...
</pre>
}}
For armadeus up to 3.4, make should be '''strictly''' make-3.81 (make-3.82 is too strict). A Fedora (14 and 15) -specific solution can be found later; other recent distributions such as mageia1 also have make-3.82, and a generic solution, based on configure&& make&& sudo make install can be used to install make-3.81 (which can be retrieved from http://ftp.gnu.org/gnu/make/make-6.81.tar.gz) in /usr/local/bin (and , according to one's PATH, make 3-81 can be invoked directly or as /usr/local/bin/make).

Depending on your distribution, some additional packages are required:

===Debian/Ubuntu based systems===
[[Ubuntu/Debian installation prerequisites]]

===Mandriva based systems===
[[Mandriva installation prerequisites]]

===RPM-based systems (RedHat, Fedora, CentOS)===
[[RedHat/Fedora installation prerequisites]]

===OpenSuse based systems===
[[OpenSuse installation prerequisites]]

===Gentoo based systems===
[[Gentoo installation prerequisites]]

==Get Armadeus software==
* '''If you are a "careful" user''', then download [https://gitlab.com/armadeus/armadeus-bsp/-/tags the latest stable installation tarball from gitlab] and detar it wherever you want:
<pre class="host">
$ tar xjvf armadeus-7.0.tar.bz2
</pre>
* '''If you want the latest snapshot or if you have an [[OPOS6UL]]''', the whole development tree can be checked out from our [[GIT]] repository.
<pre class="host">
$ git clone git@gitlab.com:armadeus/armadeus-bsp.git armadeus
</pre>

* depending on your previous choice, a directory named ''armadeus/'' or ''armadeus-7.0/'' will be created on your hard-disk and will contain all the files you need.

'''Remarks''':
* '''Do not use spaces''' in the directory name !
* '''Do not use a directory path beginning with /usr.''' It is a known bug of Buildroot (until BR2012.11, at 2012-12).
* GIT write/push accesses are limited to the integrators ([[User:JulienB|JulienB]], [[User:SebastienSz|SebastienSz]], [[User:Jorasse|Jorasse]], [[User:FabienM|FabienM]], [[User:SebastienR|SebastienR]])

==Configure SDK/BSP options==
{{Note|If you are new to Armadeus and have troubles compiling armadeus-5.x/armadeus-6.x using the following instructions, you may find some hints here: [[Releases]]}}
*Go to the directory where you put the Armadeus sources:
<pre class="host">
$ cd armadeus/ (or armadeus-7.0/)
</pre>
*The first time you compile an Armadeus distribution you have to specify the target (here the [[APF9328]]) to work with.
<pre class="host">
$ make apf9328_defconfig
</pre>
This command reloads the default configuration to support your target and automatically start a Buildroot's configuration menu.

* Current valid default configurations are:
<pre class="host">
apf9328_defconfig apf27_defconfig pps_defconfig apf28_defconfig apf51_defconfig pps51_defconfig apf6_defconfig apf6legacy_defconfig opos6ul_defconfig opos6ulnano_defconfig
</pre>
{{Note| To get the full list of available config just type make, it will download buildroot and print following message :
<pre class="host">
$ make
[...]
System not configured. Use make <board>_defconfig
armadeus valid configurations are:
opos6ul_legacy_defconfig opos6ulnano-preempt-rt_defconfig apf6_defconfig pps_defconfig opos6ultest_defconfig apf51_defconfig opos6ulsp_defconfig apf6dawnsmalllinux_defconfig apf27preempt-rt_defconfig apf27test_defconfig apf27_defconfig apf28legacytest_defconfig opos6ullegacy-4.14_defconfig opos6ulnano_defconfig apf28legacy_defconfig apf6mainline-4.19_defconfig opos6ul_defconfig apf6legacy_defconfig apf6xenomai_defconfig apf51test_defconfig opos6ul-preempt-rt_defconfig apf6legacy-preempt-rt_defconfig apf6legacy-4.1_defconfig pps51_defconfig apf6mainline-4.9_defconfig apf28test_defconfig apf28_defconfig apf6mediacenter_defconfig opos6ullegacy-4.9_defconfig opos6ul_recovery_defconfig apf6failsafe_defconfig apf6test_defconfig opos6ullegacy-4.1_defconfig apf27xenomai_defconfig

Makefile:129: recipe for target '/usr/local/projects/apf6_sp_419/buildroot/.configured' failed
make: *** [/usr/local/projects/apf6_sp_419/buildroot/.configured] Error 1
</pre>
}}

For PPS boards, please see [[APF27_PPS]] or [[PPS51]] Wiki pages, as these boards have specific build.

* After some downloads, you will get the Buildroot configuration interface:

{{Note|If you ever made changes during the following steps, at any time, you can reload the default configuration with:
$ make xxx_defconfig (xxx depending on your module name)}}

[[Image:Menuconfig3.png]] 
*If you are not familiar with Buildroot here are some tips:
*# you can move the highlighted item with the "up"/"down" arrow keys
*# with the "left"/"right" arrow keys you can choose between "Select", "Exit" or "Help" buttons
*# "space"/"enter":
*#* selects the currently highlighted item if you are on the "Select" button
*#* go back in previous menu if you are on "Exit" button
*#* show you some Help for current item if you are on "Help" button
*# for more Help about Buildroot commands, select "Help" in the main configuration screen

* Update the memory configuration of your board ('''if needed'''; by default BSP is configured for the minimal memory configuration available on the corresponding board):

:In menu:
:<pre class="config">System configuration ---> [*] Armadeus Device Support ---></pre>

:you can check and change the quantity of RAM available on your Armadeus board:
:[[Image:Build_config_memory.png]]
:For [[APF9328]] the memory can be either 16 or 32MiB (be sure to select 1 RAM chip)
:For [[APF27]] it could be either 64MiB or 128MiB (2 x 64MiB) (in that case be sure to select 2 chips of 64MiB instead of 1 chip of 128MiB).
:For [[APF51]] it could be either 256MiB or 512MiB (2x256MiB) (in such case be sure to select 2 chips of 256MiB instead of 1 chip of 512).
:For [[APF28]] The memory can be 128, 256, 512 or 1024MiB (be sure to select 1 RAM chip).
:For [[APF6]]/[[APF6SP]] The memory can be 512 Mbytes or 1Gbytes with ram chip size of 512Mbytes.
:For [[OPOS6UL]]/[[OPOS6UL_NANO]] The memory size is automatically detected so you don't care ;-)

* You may decrease the compilation time by increasing the number of parallel jobs running simultaneously on your system (the result is not guaranteed). This option is located in:
:<pre class="config">Build Options ---> (0) Number of jobs to run simultaneously</pre>
0 means that Buildroot will try to guess automatically how much parallel jobs it can launch.

* During the SDK/BSP build, a lot of software archives are downloaded from Internet. The downloaded files are put by default in the ''armadeus/downloads/'' directory. '''If you have several views or plan to build the toolchain several times''', we advise you to put all the downloaded files in ''/local/downloads'' (for example). This is done by configuring Buildroot to use this directory for all your views. Nevertheless, Buildroot will be downloaded separately for each build environment you set up.
:<pre class="config">Build options ---> (...) Download dir</pre>
:[[Image:Build_config_download.png]]
{{Note|Of course, ''/local/downloads'' should exists on your system and you should have writing rights on it !}}
* In recent Buildroot you can also use the following method:
export BR2_DL_DIR=/local/downloads

* After the build, we advise you to copy all the files in ''downloads/'' / ''/local/downloads'' on a removable medium, in case you want to install the development tools on other systems, without to have to reload all the archives.

* Now, Exit the configuration tool and save your configuration

* You can come back to this configuration menu, by typing (your changes will be kept):
<pre class="host">
make menuconfig
</pre>

==Launch build==
$ make
The toolchain and the full distribution are automatically built. During this procedure, several files are downloaded from Internet. 
'''Please wait for a while.... it takes at least one hour for the first run!''' 
By default, the downloaded files/tarball are put in the ''armadeus/downloads/'' directory. Please see the previous chapter to know how to optimize that if you plan to build several views or want to build faster.

==Enjoy the result==
The generated binary files can be found in the subdirectory ''buildroot/output/images'':
*''apf9328-u-boot.brec'' (only on [[APF9328]]): BRecord image that can be used with the bootstrap, if U-Boot is not installed or not working (see [[BootLoader]] page)
*''xxx-u-boot.bin'': U-Boot image file to be used with U-Boot itself, (see [[BootLoader#Update_U-Boot | updating U-Boot]])
*''xxx-linux.bin'': Linux image to use with U-Boot, (see [[Target_Software_Installation#Linux_kernel_installation | updating Linux]])
*''xxx-rootfs.jffs2'': JFFS2 filesystem/rootfs image to use with U-Boot, (see [[Target_Software_Installation#Linux_rootfs_installation | updating rootfs]])
*''xxx-rootfs.ubi'' (not supported on [[APF9328]]): [[UBIFS|UBI]] filesystem/rootfs image to use with U-Boot, (see [[Target_Software_Installation#Linux_rootfs_installation | updating rootfs]])
*''xxx-rootfs.ext4'': EXT4 filesystem/rootfs image to use with U-Boot, (on [[APF6]] and [[OPOS6UL]])
*''xxx-rootfs.tar'': for an NFS/MMC based rootfs, (see [[Network_Configuration#Boot_from_NFS | Booting from NFS]] & [[MultiMediaCard#Booting_from_MMC.2FSD | Booting from a MMC/SD]])

'''Please note the new naming convention of binary files and directories (since Armadeus 4.0)'''

*''buildroot/output/build'': contains all the build results for target root filesystem, Linux, Busybox and U-Boot...
*''buildroot/output/toolchain/'': cross compilation toolchain's build dir. Binaries usable for cross-compilation are in ''buildroot/output/host/usr/bin''.
*''buildroot/output/target/'': target filessytem before generating rootfs images

More information is available in the [http://buildroot.uclibc.org/buildroot.html Buildroot's documentation]

* Note: Previous versions (3.x) of Armadeus SDK stored the generated binary files at a different place: '' ''buildroot/binaries/XX/'' (where XX was the name of your board).

<noinclude>

You then copy the binary image to your server directory:
<pre class="host">
$ cp buildroot/output/images/* /tftpboot
</pre>

==To keep your local copy/repository up-to-date with the armadeus GIT repository==
<pre class="host">
$ git pull
</pre>
This will update your working directory to the latest release.

Note: if "git pull" fails because a directory or a file already exists, then do:
$ rm -rf <this-directory/file>
$ git pull

You can do a:
$ make apfXX_defconfig
to have the latest features automatically activated.

You have to do a '''make''' to rebuild binary files and then upload the binary files to your target.

Note: if definitively everything goes wrong while it worked before the last update.
You can apply the following procedure (all your modifications in buildroot will be lost):
$ rm -rf buildroot/
$ rm Makefile
$ git pull
$ make apfXX_defconfig
$ make
$ cp buildroot/output/images/* /tftpboot

Enjoy!
</noinclude>

Bugs

2022-06-30T10:36:26Z

FabienM: /* List of known bugs and others problems reported */

==List of known bugs and others problems reported==
* If you want a day by day view on all the '''OPEN''' bugs currently reported, please consult the project repository on gitlab:
**https://gitlab.com/armadeus/armadeus-bsp/-/issues
* To have the list of bugs & workaround (if any) per Release:
** [[Releases]]

== (Very) Old releases ==
* Armadeus release 2.2
* Armadeus release 2.0

CCache seems to make some troubles for the moment:
During a second buildroot compiling, the compiler does not use the right Linux
headers. This is only visible with packages that needs system dependent headers.
(ex: compile a new buildroot and then do a make menuconfig and select additional package:
''utils-linux'' and then compile again. ...... this will not work ).

'''workaround:''' Disable ccache for the moment

* Armadeus release 1.6

If project is compiled twice then jffs2 generation of rootfs can fail

'''workaround:''' do the compilation in a new shell.

FAQ

2022-06-30T10:34:54Z

FabienM:

==General Questions==

===What is the "Armadeus Project" intended for ?===
The goal of this project is to allow everyone to easily develop embedded Open Source systems.
When all the embedded systems in the world will run open source software, life will be better ;-)

===How do I get help ?===
First take a look at the whole Wiki. If you can't find help contact us directly: [[Help:Contents]]. If you are located in France, we have members in Besançon, Montbéliard & Mulhouse who can provide help. For Swiss members, we can provide help in Basel, Lausanne & Zürich.

=== Why are there http://armadeus.org and http://armadeus.com ? Is there a company backing/hiding behind the project? ===

<http://armadeus.com> is the webpage dedicated to Armadeus Systems. 
The company develops and produces the main boards which are then available at a discount price to the association members (non commercial usage only!).

Historically the Armadeus Project (association) was founded before Armadeus Systems (company). 
After one year of existence we realized that it was quite impossible to achieve our goals without investing more time and more cash. That's why the company was founded.

The association was started for our own pleasure and also to help universities and enthusiasts develop Linux embedded systems. 
It is a non profit association and works mostly on founders' free time.

The developments (hardware/firmware/software) performed within the association are under GPL/LGPL licence. 
The hardware funded by the association can not be used in a commercial product.

=== Is there some rule to respect to contribute to the wiki? ===
Yes there are few rules that help you to contribute to update the wiki there: [[WritingRules |HowTo write articles for armadeus wiki]]

==Hardware Questions==
===Are the Armadeus boards RoHS compliant ?===
Yes

===I have an APF27 kit and my 7" Chimei LW700 LCD is blinking (RGB colors), what can I do ?===
You're probably running an old (< 3.3) Armadeus BSP release and so default LCD is Sharp LQ043. You have to change your Linux configuration to support your LCD. Please follow instructions on [[FrameBuffer|this page]].

== Gateware Questions (FPGA) ==

=== My bitstream break my APF ===

If you are using ISE13.x or upper, there is a bug loading script TCL file. When design is generated by POD, a script is sourced to make bitstream (myproject.tcl), the source commande ignore the constraint file (ucf) and FPGA pinout is done randomly. To avoid this, once tcl script sourced, re-run all design.

==Software Questions==
===Where are the sources ?===

We have a project on gitlab : https://gitlab.com/armadeus/armadeus-bsp

===What are the performances of your board ?===
[[Performances | Wiki page talking about board performances]]

===How do I get help/support===
[[Help:Contents]]

=== How to register my interrupt routine in Linux application ? ===
[[How to register my interrupt routine in Linux application ?]]

=== How to launch my application at startup ? ===
See [[Automatically_launch_your_application | Automatically launch your application]] page.

===U-Boot seems ok but prints: *** Warning - bad CRC, using default environment - Is there something wrong?===
Everything is ok. It is an U-Boot feature that happens if the environment partition is empty. 
Please read the U-Boot FAQ on this issue: http://www.denx.de/wiki/view/DULG/WarningBadCRCUsingDefaultEnvironment

{{LanguageBar|FAQ|FAQ|FAQ}}

2022 02 18 Container docker pour vieux BSP

2022-02-21T08:37:25Z

FabienM: /* Le Dockerfile Armadeus */

= Introduction =

Avec la pénurie de composants actuelle beaucoup d'entreprises sont contraintes de modifier leurs cartes électroniques de manière à supporter des variantes de leurs composants. Ce changement de composants impose souvent de retoucher le logiciel et de «remettre les mains dans le code» archivé depuis belle lurette.
Le temps du développement n'étant pas celui de la production, les projets sont souvent «figés» de longue date. Et les machines qui permettaient de compiler le matériel sont totalement obsolète quand le produit est en «full-prod».

Réinstaller les vieux logiciels qui ont permis de développer le produit se révèle souvent une gageur sur des systèmes actuels.

Heureusement pour Armadeus, tout le développement de ses cartes se fait sous Linux. Et nous avons aujourd'hui un outils formidable pour faire tourner de vieux logiciel sur des systèmes «à jour» : '''la virtualisation légère''', avec notamment le logiciel [https://fr.wikipedia.org/wiki/Docker_(logiciel) docker].

= Docker, la virtualisation légère =

Selon [https://fr.wikipedia.org/wiki/Docker_(logiciel) Wikipedia] Docker est «une plateforme permettant de lancer certaines applications dans des conteneurs logiciels. Docker étend le format de conteneur Linux standard, LXC, avec une API de haut niveau fournissant une solution pratique de virtualisation qui exécute les processus de façon isolée2.»

Dit simplement, Docker est une machine virtuelle qui émule le système d'exploitation et les librairies mais pas les instructions machine. Ce qui en fait une machine virtuelle très performante.

Docker est très intéressant pour faire tourner un programme dans un environnement logiciels contrôlé avec des versions figées. C'est par exemple le cas pour compiler un BSP en utilisant une vieille distribution linux.

= Compilation du BSP armadeus pour APF27 =

L'APF27 est typiquement la carte qui est encore actuellement en production chez armadeus mais dont le BSP n'est plus utilisable avec les outils actuels. À l'origine, le BSP de l'apf27 était compilé sur des version d'ubuntu datant des années 2010 !

Si l'on veut pouvoir reprendre son projet sans avoir à redémarrer un ordinateur de cette époque, voici comment faire avec docker.
L'exemple de cet article a été réalisé sur une distribution ubuntu version Ubuntu 20.04.3 LTS.

== Lancement de Docker ==

Docker est un «deamon» qu'il faut lancer en tâche de fond sur son système. Sur Ubuntu c'est systemd qui contrôle ça :
<source lang="sh">
$ sudo systemctl start docker
</source>

Une fois que docker tourne en tâche de fond, on peu lancer directement une console `bash` ubuntu version 12.04 avec la commande
<source lang="sh">
$ sudo docker run -it ubuntu:12.04 /bin/bash
root@1a5b88e1759c:/# cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=12.04
DISTRIB_CODENAME=precise
DISTRIB_DESCRIPTION="Ubuntu 12.04.5 LTS"
root@1a5b88e1759c:/#
</source>

Un container existe déjà sur les serveurs docker avec une version minimaliste. En tapant la commande ci-dessus, docker va simplement télécharger le container pour le lancer sur la machine.

Notre shell bash tourne bien dans une distribution ubuntu version 12.04. Pour visualiser les container actifs dans docker on lancera la commande suivant dans une autre console :
<source lang="sh">
$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
1a5b88e1759c ubuntu:12.04 "/bin/bash" 2 minutes ago Up 2 minutes stoic_noether
</source>

Si l'on quitte la console avec `exit`, le container sera mis en inactif et il faudra le relancer pour pouvoir s'y ré-attacher :

<source>
root@1a5b88e1759c:/# exit
exit
$ sudo docker container start stoic_noether
stoic_noether
$ sudo docker attach stoic_noether
root@1a5b88e1759c:/# history
1 ls
2 top
3 cat /etc/lsb-release
4 exit
5 history
root@1a5b88e1759c:/#
</source>

Une fois que l'on se trouve dans la console on peut tenter de télécharger et compiler le bsp armadeus-7.0 par exemple :

<source lang="sh">
root@3264de07ca45:/# cd /opt/
root@3264de07ca45:/opt# mkdir bsp
root@3264de07ca45:/opt# cd bsp/
root@3264de07ca45:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download
bash: wget: command not found
root@3264de07ca45:/opt/bsp# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
E: Unable to locate package wget
root@3264de07ca45:/opt/bsp# apt-get update
Ign http://archive.ubuntu.com precise Release.gpg
[...]
E: Some index files failed to download. They have been ignored, or old ones used instead.
root@3264de07ca45:/opt/bsp#
</source>

Ach! Très vite on se rend compte que la distribution fournie par docker est bien trop minimaliste pour que l'on puisse travailler avec. Nous allons donc devoir construire notre propre container qui partira de cette distribution pour la customiser.

== Construction d'un container ==

Pour construire son propre container, il faut créer un fichier de configuration avec le nom '''Dockerfile'''. Dans lequel on donnera le container de départ :
<source lang="INI">
#Simple commentaire d'entête
FROM ubuntu:12.04

# on ajoute les dépots apt encore accessible aujourd'hui

# Sources from https://gist.github.com/ivomts/4558134
RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
</source>

Et on construit le container en lui donnant un nom et une version :
<source lang="sh">
$ sudo docker build -t apf27bsp:0.1 .
Sending build context to Docker daemon 2.56kB
Step 1/2 : FROM ubuntu:12.04
---> 5b117edd0b76
Step 2/2 : RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
---> Running in 0b854be1e236
Removing intermediate container 0b854be1e236
---> 9c3cb7850267
Successfully built 9c3cb7850267
Successfully tagged apf27bsp:0.1
</source>

Le container ainsi construit peut être lancé avec la commande que l'on connaît bien maintenant :
<source>
$ sudo docker container run -it apf27bsp:0.1 /bin/bash
root@d6f2e3190f9b:/# apt-get update
Get:1 http://old-releases.ubuntu.com precise Release.gpg [198 B]
...
root@d6f2e3190f9b:/# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following extra packages will be installed:
libidn11
The following NEW packages will be installed:
libidn11 wget
0 upgraded, 2 newly installed, 0 to remove and 27 not upgraded.
Need to get 392 kB of archives.
After this operation, 970 kB of additional disk space will be used.
Do you want to continue [Y/n]? y
...
root@d6f2e3190f9b:/# cd /opt/
root@d6f2e3190f9b:/opt# ls
root@d6f2e3190f9b:/opt# mkdir bsp
root@d6f2e3190f9b:/opt# cd bsp/
root@d6f2e3190f9b:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download --no-check-certificate
...
Saving to: `download'

100%[=========================================================================================================================================================================>] 6,572,959 1.87M/s in 3.8s

2022-02-18 15:58:54 (1.67 MB/s) - `download' saved [6572959/6572959]

root@d6f2e3190f9b:/opt/bsp# mv download armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp# apt-get install bzip2
root@d6f2e3190f9b:/opt/bsp# tar jxf armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp#
</source>

Très vite on se rend compte que nous avons beaucoup de logiciels à télécharger et installer. Le problème des containers c'est que rien n'est enregistré, donc à chaque fois qu'on lance le container avec la commande `run` tout est remis à zéro.

Il devient donc indispensable d'ajouter les commandes de mise à jour des packages dans le `Dockerfile`. Heureusement, Armadeus propose un script pour ça dans son BSP comme nous allons le voir par la suite.

== Montage de répertoires «host» ==

Pour récupérer les fichiers que l'on compile avec le container il va être nécessaire de «monter» un répertoire de son ordinateur dans le container.

Ce montage se fait au lancement du container. Par exemple si nous souhaitons monter le répertoire de téléchargement des packets buildroot ainsi que le répertoire du bsp armadeus nous utiliserons la commande :

<source lang="sh">
sudo docker run --mount src=/downloads,target=/downloads,type=bind \
--mount src=/home/user/prj/armadeusbsp,target=/opt/bsp/,type=bind \
-it apf27bsp:1.0 /bin/bash
</source>

Nous mutualiserons ainsi le répertoires /downloads de notre machine et nous récupérerons les binaires générés à la compilation du bsp dans le container.

== Le Dockerfile Armadeus ==

Armadeus fourni le [https://sourceforge.net/p/armadeus/code/ci/master/tree/scripts/docker/apf27-ubuntu-12.04/ Dockerfile pour compiler l'apf27]. Le script se trouve dans le répertoire `scripts/docker/apf27-ubuntu-12.04` du bsp. Un fichier README.md donne la marche à suivre pour le construire et le lancer.

Pour construire le container, il suffit de se rendre dans le répertoire et de taper la commande :
<pre>
sudo docker build -t apf27bsp:0.1 .
</pre>

2022 02 18 Container docker pour vieux BSP

2022-02-21T08:32:19Z

FabienM: /* Construction d'un container */

= Introduction =

Avec la pénurie de composants actuelle beaucoup d'entreprises sont contraintes de modifier leurs cartes électroniques de manière à supporter des variantes de leurs composants. Ce changement de composants impose souvent de retoucher le logiciel et de «remettre les mains dans le code» archivé depuis belle lurette.
Le temps du développement n'étant pas celui de la production, les projets sont souvent «figés» de longue date. Et les machines qui permettaient de compiler le matériel sont totalement obsolète quand le produit est en «full-prod».

Réinstaller les vieux logiciels qui ont permis de développer le produit se révèle souvent une gageur sur des systèmes actuels.

Heureusement pour Armadeus, tout le développement de ses cartes se fait sous Linux. Et nous avons aujourd'hui un outils formidable pour faire tourner de vieux logiciel sur des systèmes «à jour» : '''la virtualisation légère''', avec notamment le logiciel [https://fr.wikipedia.org/wiki/Docker_(logiciel) docker].

= Docker, la virtualisation légère =

Selon [https://fr.wikipedia.org/wiki/Docker_(logiciel) Wikipedia] Docker est «une plateforme permettant de lancer certaines applications dans des conteneurs logiciels. Docker étend le format de conteneur Linux standard, LXC, avec une API de haut niveau fournissant une solution pratique de virtualisation qui exécute les processus de façon isolée2.»

Dit simplement, Docker est une machine virtuelle qui émule le système d'exploitation et les librairies mais pas les instructions machine. Ce qui en fait une machine virtuelle très performante.

Docker est très intéressant pour faire tourner un programme dans un environnement logiciels contrôlé avec des versions figées. C'est par exemple le cas pour compiler un BSP en utilisant une vieille distribution linux.

= Compilation du BSP armadeus pour APF27 =

L'APF27 est typiquement la carte qui est encore actuellement en production chez armadeus mais dont le BSP n'est plus utilisable avec les outils actuels. À l'origine, le BSP de l'apf27 était compilé sur des version d'ubuntu datant des années 2010 !

Si l'on veut pouvoir reprendre son projet sans avoir à redémarrer un ordinateur de cette époque, voici comment faire avec docker.
L'exemple de cet article a été réalisé sur une distribution ubuntu version Ubuntu 20.04.3 LTS.

== Lancement de Docker ==

Docker est un «deamon» qu'il faut lancer en tâche de fond sur son système. Sur Ubuntu c'est systemd qui contrôle ça :
<source lang="sh">
$ sudo systemctl start docker
</source>

Une fois que docker tourne en tâche de fond, on peu lancer directement une console `bash` ubuntu version 12.04 avec la commande
<source lang="sh">
$ sudo docker run -it ubuntu:12.04 /bin/bash
root@1a5b88e1759c:/# cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=12.04
DISTRIB_CODENAME=precise
DISTRIB_DESCRIPTION="Ubuntu 12.04.5 LTS"
root@1a5b88e1759c:/#
</source>

Un container existe déjà sur les serveurs docker avec une version minimaliste. En tapant la commande ci-dessus, docker va simplement télécharger le container pour le lancer sur la machine.

Notre shell bash tourne bien dans une distribution ubuntu version 12.04. Pour visualiser les container actifs dans docker on lancera la commande suivant dans une autre console :
<source lang="sh">
$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
1a5b88e1759c ubuntu:12.04 "/bin/bash" 2 minutes ago Up 2 minutes stoic_noether
</source>

Si l'on quitte la console avec `exit`, le container sera mis en inactif et il faudra le relancer pour pouvoir s'y ré-attacher :

<source>
root@1a5b88e1759c:/# exit
exit
$ sudo docker container start stoic_noether
stoic_noether
$ sudo docker attach stoic_noether
root@1a5b88e1759c:/# history
1 ls
2 top
3 cat /etc/lsb-release
4 exit
5 history
root@1a5b88e1759c:/#
</source>

Une fois que l'on se trouve dans la console on peut tenter de télécharger et compiler le bsp armadeus-7.0 par exemple :

<source lang="sh">
root@3264de07ca45:/# cd /opt/
root@3264de07ca45:/opt# mkdir bsp
root@3264de07ca45:/opt# cd bsp/
root@3264de07ca45:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download
bash: wget: command not found
root@3264de07ca45:/opt/bsp# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
E: Unable to locate package wget
root@3264de07ca45:/opt/bsp# apt-get update
Ign http://archive.ubuntu.com precise Release.gpg
[...]
E: Some index files failed to download. They have been ignored, or old ones used instead.
root@3264de07ca45:/opt/bsp#
</source>

Ach! Très vite on se rend compte que la distribution fournie par docker est bien trop minimaliste pour que l'on puisse travailler avec. Nous allons donc devoir construire notre propre container qui partira de cette distribution pour la customiser.

== Construction d'un container ==

Pour construire son propre container, il faut créer un fichier de configuration avec le nom '''Dockerfile'''. Dans lequel on donnera le container de départ :
<source lang="INI">
#Simple commentaire d'entête
FROM ubuntu:12.04

# on ajoute les dépots apt encore accessible aujourd'hui

# Sources from https://gist.github.com/ivomts/4558134
RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
</source>

Et on construit le container en lui donnant un nom et une version :
<source lang="sh">
$ sudo docker build -t apf27bsp:0.1 .
Sending build context to Docker daemon 2.56kB
Step 1/2 : FROM ubuntu:12.04
---> 5b117edd0b76
Step 2/2 : RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
---> Running in 0b854be1e236
Removing intermediate container 0b854be1e236
---> 9c3cb7850267
Successfully built 9c3cb7850267
Successfully tagged apf27bsp:0.1
</source>

Le container ainsi construit peut être lancé avec la commande que l'on connaît bien maintenant :
<source>
$ sudo docker container run -it apf27bsp:0.1 /bin/bash
root@d6f2e3190f9b:/# apt-get update
Get:1 http://old-releases.ubuntu.com precise Release.gpg [198 B]
...
root@d6f2e3190f9b:/# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following extra packages will be installed:
libidn11
The following NEW packages will be installed:
libidn11 wget
0 upgraded, 2 newly installed, 0 to remove and 27 not upgraded.
Need to get 392 kB of archives.
After this operation, 970 kB of additional disk space will be used.
Do you want to continue [Y/n]? y
...
root@d6f2e3190f9b:/# cd /opt/
root@d6f2e3190f9b:/opt# ls
root@d6f2e3190f9b:/opt# mkdir bsp
root@d6f2e3190f9b:/opt# cd bsp/
root@d6f2e3190f9b:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download --no-check-certificate
...
Saving to: `download'

100%[=========================================================================================================================================================================>] 6,572,959 1.87M/s in 3.8s

2022-02-18 15:58:54 (1.67 MB/s) - `download' saved [6572959/6572959]

root@d6f2e3190f9b:/opt/bsp# mv download armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp# apt-get install bzip2
root@d6f2e3190f9b:/opt/bsp# tar jxf armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp#
</source>

Très vite on se rend compte que nous avons beaucoup de logiciels à télécharger et installer. Le problème des containers c'est que rien n'est enregistré, donc à chaque fois qu'on lance le container avec la commande `run` tout est remis à zéro.

Il devient donc indispensable d'ajouter les commandes de mise à jour des packages dans le `Dockerfile`. Heureusement, Armadeus propose un script pour ça dans son BSP comme nous allons le voir par la suite.

== Montage de répertoires «host» ==

Pour récupérer les fichiers que l'on compile avec le container il va être nécessaire de «monter» un répertoire de son ordinateur dans le container.

Ce montage se fait au lancement du container. Par exemple si nous souhaitons monter le répertoire de téléchargement des packets buildroot ainsi que le répertoire du bsp armadeus nous utiliserons la commande :

<source lang="sh">
sudo docker run --mount src=/downloads,target=/downloads,type=bind \
--mount src=/home/user/prj/armadeusbsp,target=/opt/bsp/,type=bind \
-it apf27bsp:1.0 /bin/bash
</source>

Nous mutualiserons ainsi le répertoires /downloads de notre machine et nous récupérerons les binaires générés à la compilation du bsp dans le container.

== Le Dockerfile Armadeus ==

Armadeus fourni le Dockerfile pour compiler l'apf27, il suffit donc de le construire en se rendant dans le répertoire `scripts/docker/apf27-ubuntu-12.04` du bsp. Un fichier README.md donne la marche à suivre pour le construire et le lancer.

Template:DernièresNouvelles

2022-02-21T08:27:47Z

FabienM: /* 18 Février 2022: Container docker pour vieux BSP */

__NOTOC__

=====18 Février 2022: Container docker pour vieux BSP=====
<noinclude>
[[2022_02_18_Container_docker_pour_vieux_BSP| Comment utiliser une vieille distribution Linux sur un ordinateur récent pour pouvoir compiler le BSP pour apf27 en toute tranquilité]]
</noinclude>

=====7 Août 2018: La nouvelle version [[Releases#Release_7.0_.28latest_stable_one.29|Armadeus 7.0]] est disponible=====
<noinclude>
Cette nouvelle [[Releases#Release_7.0_.28latest_stable_one.29| version]] ajoute le support des nouveaux SoM [[OPOS6UL]] et [[OPOS6UL_NANO]] et finalise la mise à jour vers Buildroot 2017.02.</noinclude>

=====11 Août 2015: La nouvelle version [[Releases#Release_6.0_.28latest_stable_one.29|Armadeus 6.0]] est disponible=====
<noinclude>
Cette nouvelle [[Releases#Release_6.0_.28latest_stable_one.29| version]] ajoute le support des nouveaux modules Armadeus ([[APF6]] et [[APF6_SP]]) et finalise la mise à jour vers Buildroot 2015.02 et U-Boot 2014.07+. Elle améliore aussi le support pour les noyaux Linux vanilla (3.19+).</noinclude>

=====25 Décembre 2013: La nouvelle version [[Releases#Release_5.3_.28latest_stable_one.29|Armadeus 5.3]] est disponible=====
<noinclude>
Cette nouvelle [[Releases#Release_5.3_.28latest_stable_one.29| version]] finalise la mise à jour vers Buildroot 2013.05 et U-Boot 2013.04. Elle ajoute aussi le support pour les noyaux Linux vanilla (3.1x). L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-5-3-du-bsp-du-projet-armadeus].</noinclude>

<noinclude>
=====12 Octobre 2012: Nouvelle version du logiciel Armadeus: [[Releases#Release_5.2_.28latest_stable_one.29|Armadeus 5.2]] est disponible=====
Cette nouvelle [[Releases#Release_5.2_.28latest_stable_one.29| version]] ajoute de nouvelles fonctionnalitées a la carte [[APF28]] , corrige un probleme sur l interface wifi de la carte PPS et ajoute plusieurs ameliorations au logiciel Armadeus </noinclude>

<noinclude>
=====12 Août 2012: La release Armadeus 5.0 est sortie=====
Cette nouvelle release ajoute le support stable de l'[[APF28]], BR 2012.02, U-Boot 2012.04. Plus les corrections de bugs et les améliorations d'utilisation habituelles bien sûr.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-5-0-du-projet-armadeus].</noinclude>

<noinclude>
=====27 Janvier 2012: La release Armadeus 4.1 est sortie=====
Cette nouvelle release ajoute le pré-support (vraiment expérimental) de l'[[APF28]], BR 2011.05, une meilleure intégration de BR, Linux 3.0 pour APF51 et de nouveaux packages orientés automatisation industrielle. Plus les corrections de bugs et les améliorations d'utilisation habituelles bien sûr.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-4-1-du-projet-armadeus].</noinclude>

<noinclude>
=====Certains membres d'Armadeus Project tiendront un stand (71) aux RMLL 2011 à Strasbourg (du 11 au 14 Juillet)=====</noinclude>

<noinclude>
=====9 Juillet 2011: La release Armadeus 4.0 est sortie=====
Cette nouvelle release ajoute le support pour l'[[APF51]] , BR 2010.11 et continue le travail d'intégration (expérimental) de Linux 2.6.38 pour APF27/PPS et APF9328.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-40-du-projet-armadeus].</noinclude>

<noinclude>
=====1er Mai 2011: Le module [[APF51]] et sa carte d'accueil [[APF51Dev]] sont disponibles=====
Ces nouvelles cartes surpuissantes ( ;-) ) sont disponible dans la boutique en ligne d'Armadeus Systems.</noinclude>

<noinclude>
=====3 Mars 2011: [[Release_3.4|La release Armadeus 3.4]] est sortie=====
Cette nouvelle release ajoute le support pour la carte d'accueil [[APF27_PPS]] et continue le travail d'intégration (expérimental) de Linux 2.6.38 et Buildroot 2010.xx.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version 34-du- projet-armadeus]. </noinclude>

<noinclude>
=====30 Juillet 2010: [[Release_3.3|La release Armadeus 3.3]] est sortie=====
Cette nouvelle release améliore le support pour l'[[Wireless_extension_board|APW]], WiFi, Bluetooth, GPS, ajoute Qt 4.5.3, BR 2010.05 & U-Boot 2010.03 (expérimental), etc...
L'annonce sur LinuxFr: [http://linuxfr.org/2010/08/24/27281.html].</noinclude>

<noinclude>
=====15 Janvier 2010: La carte APW est disponible=====
La nouvelle carte [[Wireless_extension_board|APW]] (extension "Wireless" pour l'APF27) est disponible dans la boutique en ligne d'Armadeus Systems.</noinclude>

<noinclude>
=====1er Décembre 2009: [[Release_3.2|La release Armadeus 3.2]] est sortie=====
La nouvelle release Armadeus 3.2 améliore le support [[APF27]], ajoute un écran 7 pouces, de nouveaux packages (pygame, xenomai, etc...), migration svn vers git, etc...
L'annonce sur LinuxFr: [http://linuxfr.org/2009/12/02/26228.html]</noinclude>

<noinclude>
=====29 Juin 2009: La release Armadeus 3.1 est sortie, suivant la disponibilité des [[APF27Dev|APF27DevFull]]=====
La nouvelle release Armadeus 3.1 supporte désormais Linux 2.6.29, GDB 6.7.1, la sortie HDMI de l'APF27DevFull, le FPGA de l'APF27 et une foultitude de nouveautés. 
Elle peut être téléchargée sous forme d'archive à [http://sourceforge.net/project/showfiles.php?group_id=122057 l'endroit habituel.]</noinclude>

<noinclude>
=====26 Février 2009: La release [[Armadeus 3]] est sortie, juste après les [[APF27]]=====
La nouvelle release Armadeus 3.0 supporte la nouvelle carte d'Armadeus Systems ([[APF27]]), Linux 2.6.27, GCC 4.2.1, U-Boot 1.3.4 et une foultitude de nouveautés. 
Elle peut être téléchargée sous forme d'archive à l'endroit habituel: http://sourceforge.net/projects/armadeus</noinclude>

<noinclude>
=====20 Mai 2008: Les cartes DevFull sont arrivées=====
Les cartes de développement [[APF9328DevFull|DevFull]] sont désormais produites et seront bientôt en vente à tarif préférentiel (pour les membres d'Armadeus Project) dans le [http://www.store.armadeus.com/index.php?language=fr magasin en ligne d'armadeus systems]</noinclude>

<noinclude>
=====15 Sept. 2007: Des cartes APF9328 ont été reçues & les premiers prototypes de DevFull sont en test=====
Toutes les cartes sont désormais disponibles. Le DevFull fonctionne bien et sera vraisemblablement disponible vers la fin de l'année.</noinclude>

<noinclude>
=====10 Juin 2007: Des DevLight et des LCD_Adapt ont été reçues, mais nous attendons toujours les APF9328 :-( !=====
Des DevLight et des LCD_Adapt ont été reçues, mais nous attendons toujours les APF9328. Date de livraison: fin Juin ??</noinclude>

<noinclude>
=====26 Mar. 2007: des DevLight et des LCD_Adapt ont été commandées !=====
De nouvelles DevLight ont été commandées ! Date de livraison: semaine 17/18 (mi-Avril)

Les LCD_Adapter ont été commandées aussi. Date de livraison: semaine 18/19

=====22 Mars 2007: Rupture de stock sur les DevLight=====
Devant l'arrivée massive de nouveaux membres, nous sommes en rupture de stock de DevLight. De nouvelles cartes ont été commandées mais elles ne seront disponibles que mi-Avril.
<noinclude>
=====01 Mars 2007: Article dans GLMF=====
Le magazine français GNU/Linux Magazine France (Linux Mag) a publié ce mois-ci notre article de présentation de l'association</noinclude>
<noinclude>
=====09 Fev. 2007: ça y est la V2.0 est sortie !=====
La version 2.0 est (enfin ;-) ) disponible. Pour la charger, RDV sur Sourceforge... Maintenant les choses sérieuses vont pouvoir commencer !</noinclude>
<noinclude>
=====05 Nov. 2006: Les APF DevLight sont prêtes !=====

Nous pouvons désormais accueillir 50 nouveaux membres ! </noinclude>
<noinclude>
=====15 Oct. 2006: Les cartes APF DevLight seront bientôt là=====
Les cartes DevLight (de développement) sont en cours de production et seront disponibles fin Octobre. </noinclude>
<noinclude>
=====12 Sept. 2006: Les cartes APF DevLight sont commandées=====
Nico a commandé 50 cartes APF DevLight aujourd'hui. Elles devraient arriver mi-Octobre. Elles permettront à un plus grand nombre de personnes de rejoindre le projet bientôt ! :-). </noinclude>
<noinclude>
=====10 Sept. 2006: Le Wiki et le site Web sont presques prêts=====
250 ans (et quelques mois) après la naissance de notre idole Wolfgang, un nouveau génie est apparu sur Terre: le projet Armadeus... ;-) </noinclude>

[[Template:DernièresNouvelles|Voir toutes les nouvelles]]

Template:DernièresNouvelles

2022-02-21T08:27:37Z

FabienM: /* 18 Février 2022: Container docker pour vieux BSP */

__NOTOC__

=====18 Février 2022: Container docker pour vieux BSP=====
<noinclude>

[[2022_02_18_Container_docker_pour_vieux_BSP| Comment utiliser une vieille distribution Linux sur un ordinateur récent pour pouvoir compiler le BSP pour apf27 en toute tranquilité]]
</noinclude>

=====7 Août 2018: La nouvelle version [[Releases#Release_7.0_.28latest_stable_one.29|Armadeus 7.0]] est disponible=====
<noinclude>
Cette nouvelle [[Releases#Release_7.0_.28latest_stable_one.29| version]] ajoute le support des nouveaux SoM [[OPOS6UL]] et [[OPOS6UL_NANO]] et finalise la mise à jour vers Buildroot 2017.02.</noinclude>

=====11 Août 2015: La nouvelle version [[Releases#Release_6.0_.28latest_stable_one.29|Armadeus 6.0]] est disponible=====
<noinclude>
Cette nouvelle [[Releases#Release_6.0_.28latest_stable_one.29| version]] ajoute le support des nouveaux modules Armadeus ([[APF6]] et [[APF6_SP]]) et finalise la mise à jour vers Buildroot 2015.02 et U-Boot 2014.07+. Elle améliore aussi le support pour les noyaux Linux vanilla (3.19+).</noinclude>

=====25 Décembre 2013: La nouvelle version [[Releases#Release_5.3_.28latest_stable_one.29|Armadeus 5.3]] est disponible=====
<noinclude>
Cette nouvelle [[Releases#Release_5.3_.28latest_stable_one.29| version]] finalise la mise à jour vers Buildroot 2013.05 et U-Boot 2013.04. Elle ajoute aussi le support pour les noyaux Linux vanilla (3.1x). L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-5-3-du-bsp-du-projet-armadeus].</noinclude>

<noinclude>
=====12 Octobre 2012: Nouvelle version du logiciel Armadeus: [[Releases#Release_5.2_.28latest_stable_one.29|Armadeus 5.2]] est disponible=====
Cette nouvelle [[Releases#Release_5.2_.28latest_stable_one.29| version]] ajoute de nouvelles fonctionnalitées a la carte [[APF28]] , corrige un probleme sur l interface wifi de la carte PPS et ajoute plusieurs ameliorations au logiciel Armadeus </noinclude>

<noinclude>
=====12 Août 2012: La release Armadeus 5.0 est sortie=====
Cette nouvelle release ajoute le support stable de l'[[APF28]], BR 2012.02, U-Boot 2012.04. Plus les corrections de bugs et les améliorations d'utilisation habituelles bien sûr.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-5-0-du-projet-armadeus].</noinclude>

<noinclude>
=====27 Janvier 2012: La release Armadeus 4.1 est sortie=====
Cette nouvelle release ajoute le pré-support (vraiment expérimental) de l'[[APF28]], BR 2011.05, une meilleure intégration de BR, Linux 3.0 pour APF51 et de nouveaux packages orientés automatisation industrielle. Plus les corrections de bugs et les améliorations d'utilisation habituelles bien sûr.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-4-1-du-projet-armadeus].</noinclude>

<noinclude>
=====Certains membres d'Armadeus Project tiendront un stand (71) aux RMLL 2011 à Strasbourg (du 11 au 14 Juillet)=====</noinclude>

<noinclude>
=====9 Juillet 2011: La release Armadeus 4.0 est sortie=====
Cette nouvelle release ajoute le support pour l'[[APF51]] , BR 2010.11 et continue le travail d'intégration (expérimental) de Linux 2.6.38 pour APF27/PPS et APF9328.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-40-du-projet-armadeus].</noinclude>

<noinclude>
=====1er Mai 2011: Le module [[APF51]] et sa carte d'accueil [[APF51Dev]] sont disponibles=====
Ces nouvelles cartes surpuissantes ( ;-) ) sont disponible dans la boutique en ligne d'Armadeus Systems.</noinclude>

<noinclude>
=====3 Mars 2011: [[Release_3.4|La release Armadeus 3.4]] est sortie=====
Cette nouvelle release ajoute le support pour la carte d'accueil [[APF27_PPS]] et continue le travail d'intégration (expérimental) de Linux 2.6.38 et Buildroot 2010.xx.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version 34-du- projet-armadeus]. </noinclude>

<noinclude>
=====30 Juillet 2010: [[Release_3.3|La release Armadeus 3.3]] est sortie=====
Cette nouvelle release améliore le support pour l'[[Wireless_extension_board|APW]], WiFi, Bluetooth, GPS, ajoute Qt 4.5.3, BR 2010.05 & U-Boot 2010.03 (expérimental), etc...
L'annonce sur LinuxFr: [http://linuxfr.org/2010/08/24/27281.html].</noinclude>

<noinclude>
=====15 Janvier 2010: La carte APW est disponible=====
La nouvelle carte [[Wireless_extension_board|APW]] (extension "Wireless" pour l'APF27) est disponible dans la boutique en ligne d'Armadeus Systems.</noinclude>

<noinclude>
=====1er Décembre 2009: [[Release_3.2|La release Armadeus 3.2]] est sortie=====
La nouvelle release Armadeus 3.2 améliore le support [[APF27]], ajoute un écran 7 pouces, de nouveaux packages (pygame, xenomai, etc...), migration svn vers git, etc...
L'annonce sur LinuxFr: [http://linuxfr.org/2009/12/02/26228.html]</noinclude>

<noinclude>
=====29 Juin 2009: La release Armadeus 3.1 est sortie, suivant la disponibilité des [[APF27Dev|APF27DevFull]]=====
La nouvelle release Armadeus 3.1 supporte désormais Linux 2.6.29, GDB 6.7.1, la sortie HDMI de l'APF27DevFull, le FPGA de l'APF27 et une foultitude de nouveautés. 
Elle peut être téléchargée sous forme d'archive à [http://sourceforge.net/project/showfiles.php?group_id=122057 l'endroit habituel.]</noinclude>

<noinclude>
=====26 Février 2009: La release [[Armadeus 3]] est sortie, juste après les [[APF27]]=====
La nouvelle release Armadeus 3.0 supporte la nouvelle carte d'Armadeus Systems ([[APF27]]), Linux 2.6.27, GCC 4.2.1, U-Boot 1.3.4 et une foultitude de nouveautés. 
Elle peut être téléchargée sous forme d'archive à l'endroit habituel: http://sourceforge.net/projects/armadeus</noinclude>

<noinclude>
=====20 Mai 2008: Les cartes DevFull sont arrivées=====
Les cartes de développement [[APF9328DevFull|DevFull]] sont désormais produites et seront bientôt en vente à tarif préférentiel (pour les membres d'Armadeus Project) dans le [http://www.store.armadeus.com/index.php?language=fr magasin en ligne d'armadeus systems]</noinclude>

<noinclude>
=====15 Sept. 2007: Des cartes APF9328 ont été reçues & les premiers prototypes de DevFull sont en test=====
Toutes les cartes sont désormais disponibles. Le DevFull fonctionne bien et sera vraisemblablement disponible vers la fin de l'année.</noinclude>

<noinclude>
=====10 Juin 2007: Des DevLight et des LCD_Adapt ont été reçues, mais nous attendons toujours les APF9328 :-( !=====
Des DevLight et des LCD_Adapt ont été reçues, mais nous attendons toujours les APF9328. Date de livraison: fin Juin ??</noinclude>

<noinclude>
=====26 Mar. 2007: des DevLight et des LCD_Adapt ont été commandées !=====
De nouvelles DevLight ont été commandées ! Date de livraison: semaine 17/18 (mi-Avril)

Les LCD_Adapter ont été commandées aussi. Date de livraison: semaine 18/19

=====22 Mars 2007: Rupture de stock sur les DevLight=====
Devant l'arrivée massive de nouveaux membres, nous sommes en rupture de stock de DevLight. De nouvelles cartes ont été commandées mais elles ne seront disponibles que mi-Avril.
<noinclude>
=====01 Mars 2007: Article dans GLMF=====
Le magazine français GNU/Linux Magazine France (Linux Mag) a publié ce mois-ci notre article de présentation de l'association</noinclude>
<noinclude>
=====09 Fev. 2007: ça y est la V2.0 est sortie !=====
La version 2.0 est (enfin ;-) ) disponible. Pour la charger, RDV sur Sourceforge... Maintenant les choses sérieuses vont pouvoir commencer !</noinclude>
<noinclude>
=====05 Nov. 2006: Les APF DevLight sont prêtes !=====

Nous pouvons désormais accueillir 50 nouveaux membres ! </noinclude>
<noinclude>
=====15 Oct. 2006: Les cartes APF DevLight seront bientôt là=====
Les cartes DevLight (de développement) sont en cours de production et seront disponibles fin Octobre. </noinclude>
<noinclude>
=====12 Sept. 2006: Les cartes APF DevLight sont commandées=====
Nico a commandé 50 cartes APF DevLight aujourd'hui. Elles devraient arriver mi-Octobre. Elles permettront à un plus grand nombre de personnes de rejoindre le projet bientôt ! :-). </noinclude>
<noinclude>
=====10 Sept. 2006: Le Wiki et le site Web sont presques prêts=====
250 ans (et quelques mois) après la naissance de notre idole Wolfgang, un nouveau génie est apparu sur Terre: le projet Armadeus... ;-) </noinclude>

[[Template:DernièresNouvelles|Voir toutes les nouvelles]]

Template:DernièresNouvelles

2022-02-18T16:27:23Z

FabienM:

__NOTOC__

=====18 Février 2022: Container docker pour vieux BSP=====
<noinclude>

[[2022_02_18_Container_docker_pour_vieux_BSP| Comment utiliser une vieille distribution Linux pour pouvoir compiler le BSP pour apf27 en toute tranquilité]]
</noinclude>
=====7 Août 2018: La nouvelle version [[Releases#Release_7.0_.28latest_stable_one.29|Armadeus 7.0]] est disponible=====
<noinclude>
Cette nouvelle [[Releases#Release_7.0_.28latest_stable_one.29| version]] ajoute le support des nouveaux SoM [[OPOS6UL]] et [[OPOS6UL_NANO]] et finalise la mise à jour vers Buildroot 2017.02.</noinclude>

=====11 Août 2015: La nouvelle version [[Releases#Release_6.0_.28latest_stable_one.29|Armadeus 6.0]] est disponible=====
<noinclude>
Cette nouvelle [[Releases#Release_6.0_.28latest_stable_one.29| version]] ajoute le support des nouveaux modules Armadeus ([[APF6]] et [[APF6_SP]]) et finalise la mise à jour vers Buildroot 2015.02 et U-Boot 2014.07+. Elle améliore aussi le support pour les noyaux Linux vanilla (3.19+).</noinclude>

=====25 Décembre 2013: La nouvelle version [[Releases#Release_5.3_.28latest_stable_one.29|Armadeus 5.3]] est disponible=====
<noinclude>
Cette nouvelle [[Releases#Release_5.3_.28latest_stable_one.29| version]] finalise la mise à jour vers Buildroot 2013.05 et U-Boot 2013.04. Elle ajoute aussi le support pour les noyaux Linux vanilla (3.1x). L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-5-3-du-bsp-du-projet-armadeus].</noinclude>

<noinclude>
=====12 Octobre 2012: Nouvelle version du logiciel Armadeus: [[Releases#Release_5.2_.28latest_stable_one.29|Armadeus 5.2]] est disponible=====
Cette nouvelle [[Releases#Release_5.2_.28latest_stable_one.29| version]] ajoute de nouvelles fonctionnalitées a la carte [[APF28]] , corrige un probleme sur l interface wifi de la carte PPS et ajoute plusieurs ameliorations au logiciel Armadeus </noinclude>

<noinclude>
=====12 Août 2012: La release Armadeus 5.0 est sortie=====
Cette nouvelle release ajoute le support stable de l'[[APF28]], BR 2012.02, U-Boot 2012.04. Plus les corrections de bugs et les améliorations d'utilisation habituelles bien sûr.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-5-0-du-projet-armadeus].</noinclude>

<noinclude>
=====27 Janvier 2012: La release Armadeus 4.1 est sortie=====
Cette nouvelle release ajoute le pré-support (vraiment expérimental) de l'[[APF28]], BR 2011.05, une meilleure intégration de BR, Linux 3.0 pour APF51 et de nouveaux packages orientés automatisation industrielle. Plus les corrections de bugs et les améliorations d'utilisation habituelles bien sûr.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-4-1-du-projet-armadeus].</noinclude>

<noinclude>
=====Certains membres d'Armadeus Project tiendront un stand (71) aux RMLL 2011 à Strasbourg (du 11 au 14 Juillet)=====</noinclude>

<noinclude>
=====9 Juillet 2011: La release Armadeus 4.0 est sortie=====
Cette nouvelle release ajoute le support pour l'[[APF51]] , BR 2010.11 et continue le travail d'intégration (expérimental) de Linux 2.6.38 pour APF27/PPS et APF9328.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version-40-du-projet-armadeus].</noinclude>

<noinclude>
=====1er Mai 2011: Le module [[APF51]] et sa carte d'accueil [[APF51Dev]] sont disponibles=====
Ces nouvelles cartes surpuissantes ( ;-) ) sont disponible dans la boutique en ligne d'Armadeus Systems.</noinclude>

<noinclude>
=====3 Mars 2011: [[Release_3.4|La release Armadeus 3.4]] est sortie=====
Cette nouvelle release ajoute le support pour la carte d'accueil [[APF27_PPS]] et continue le travail d'intégration (expérimental) de Linux 2.6.38 et Buildroot 2010.xx.
L'annonce sur LinuxFr: [http://linuxfr.org/news/sortie-de-la-version 34-du- projet-armadeus]. </noinclude>

<noinclude>
=====30 Juillet 2010: [[Release_3.3|La release Armadeus 3.3]] est sortie=====
Cette nouvelle release améliore le support pour l'[[Wireless_extension_board|APW]], WiFi, Bluetooth, GPS, ajoute Qt 4.5.3, BR 2010.05 & U-Boot 2010.03 (expérimental), etc...
L'annonce sur LinuxFr: [http://linuxfr.org/2010/08/24/27281.html].</noinclude>

<noinclude>
=====15 Janvier 2010: La carte APW est disponible=====
La nouvelle carte [[Wireless_extension_board|APW]] (extension "Wireless" pour l'APF27) est disponible dans la boutique en ligne d'Armadeus Systems.</noinclude>

<noinclude>
=====1er Décembre 2009: [[Release_3.2|La release Armadeus 3.2]] est sortie=====
La nouvelle release Armadeus 3.2 améliore le support [[APF27]], ajoute un écran 7 pouces, de nouveaux packages (pygame, xenomai, etc...), migration svn vers git, etc...
L'annonce sur LinuxFr: [http://linuxfr.org/2009/12/02/26228.html]</noinclude>

<noinclude>
=====29 Juin 2009: La release Armadeus 3.1 est sortie, suivant la disponibilité des [[APF27Dev|APF27DevFull]]=====
La nouvelle release Armadeus 3.1 supporte désormais Linux 2.6.29, GDB 6.7.1, la sortie HDMI de l'APF27DevFull, le FPGA de l'APF27 et une foultitude de nouveautés. 
Elle peut être téléchargée sous forme d'archive à [http://sourceforge.net/project/showfiles.php?group_id=122057 l'endroit habituel.]</noinclude>

<noinclude>
=====26 Février 2009: La release [[Armadeus 3]] est sortie, juste après les [[APF27]]=====
La nouvelle release Armadeus 3.0 supporte la nouvelle carte d'Armadeus Systems ([[APF27]]), Linux 2.6.27, GCC 4.2.1, U-Boot 1.3.4 et une foultitude de nouveautés. 
Elle peut être téléchargée sous forme d'archive à l'endroit habituel: http://sourceforge.net/projects/armadeus</noinclude>

<noinclude>
=====20 Mai 2008: Les cartes DevFull sont arrivées=====
Les cartes de développement [[APF9328DevFull|DevFull]] sont désormais produites et seront bientôt en vente à tarif préférentiel (pour les membres d'Armadeus Project) dans le [http://www.store.armadeus.com/index.php?language=fr magasin en ligne d'armadeus systems]</noinclude>

<noinclude>
=====15 Sept. 2007: Des cartes APF9328 ont été reçues & les premiers prototypes de DevFull sont en test=====
Toutes les cartes sont désormais disponibles. Le DevFull fonctionne bien et sera vraisemblablement disponible vers la fin de l'année.</noinclude>

<noinclude>
=====10 Juin 2007: Des DevLight et des LCD_Adapt ont été reçues, mais nous attendons toujours les APF9328 :-( !=====
Des DevLight et des LCD_Adapt ont été reçues, mais nous attendons toujours les APF9328. Date de livraison: fin Juin ??</noinclude>

<noinclude>
=====26 Mar. 2007: des DevLight et des LCD_Adapt ont été commandées !=====
De nouvelles DevLight ont été commandées ! Date de livraison: semaine 17/18 (mi-Avril)

Les LCD_Adapter ont été commandées aussi. Date de livraison: semaine 18/19

=====22 Mars 2007: Rupture de stock sur les DevLight=====
Devant l'arrivée massive de nouveaux membres, nous sommes en rupture de stock de DevLight. De nouvelles cartes ont été commandées mais elles ne seront disponibles que mi-Avril.
<noinclude>
=====01 Mars 2007: Article dans GLMF=====
Le magazine français GNU/Linux Magazine France (Linux Mag) a publié ce mois-ci notre article de présentation de l'association</noinclude>
<noinclude>
=====09 Fev. 2007: ça y est la V2.0 est sortie !=====
La version 2.0 est (enfin ;-) ) disponible. Pour la charger, RDV sur Sourceforge... Maintenant les choses sérieuses vont pouvoir commencer !</noinclude>
<noinclude>
=====05 Nov. 2006: Les APF DevLight sont prêtes !=====

Nous pouvons désormais accueillir 50 nouveaux membres ! </noinclude>
<noinclude>
=====15 Oct. 2006: Les cartes APF DevLight seront bientôt là=====
Les cartes DevLight (de développement) sont en cours de production et seront disponibles fin Octobre. </noinclude>
<noinclude>
=====12 Sept. 2006: Les cartes APF DevLight sont commandées=====
Nico a commandé 50 cartes APF DevLight aujourd'hui. Elles devraient arriver mi-Octobre. Elles permettront à un plus grand nombre de personnes de rejoindre le projet bientôt ! :-). </noinclude>
<noinclude>
=====10 Sept. 2006: Le Wiki et le site Web sont presques prêts=====
250 ans (et quelques mois) après la naissance de notre idole Wolfgang, un nouveau génie est apparu sur Terre: le projet Armadeus... ;-) </noinclude>

[[Template:DernièresNouvelles|Voir toutes les nouvelles]]

2022 02 18 Container docker pour vieux BSP

2022-02-18T16:24:38Z

FabienM: /* Le Dockerfile Armadeus */

= Introduction =

Avec la pénurie de composants actuelle beaucoup d'entreprises sont contraintes de modifier leurs cartes électroniques de manière à supporter des variantes de leurs composants. Ce changement de composants impose souvent de retoucher le logiciel et de «remettre les mains dans le code» archivé depuis belle lurette.
Le temps du développement n'étant pas celui de la production, les projets sont souvent «figés» de longue date. Et les machines qui permettaient de compiler le matériel sont totalement obsolète quand le produit est en «full-prod».

Réinstaller les vieux logiciels qui ont permis de développer le produit se révèle souvent une gageur sur des systèmes actuels.

Heureusement pour Armadeus, tout le développement de ses cartes se fait sous Linux. Et nous avons aujourd'hui un outils formidable pour faire tourner de vieux logiciel sur des systèmes «à jour» : '''la virtualisation légère''', avec notamment le logiciel [https://fr.wikipedia.org/wiki/Docker_(logiciel) docker].

= Docker, la virtualisation légère =

Selon [https://fr.wikipedia.org/wiki/Docker_(logiciel) Wikipedia] Docker est «une plateforme permettant de lancer certaines applications dans des conteneurs logiciels. Docker étend le format de conteneur Linux standard, LXC, avec une API de haut niveau fournissant une solution pratique de virtualisation qui exécute les processus de façon isolée2.»

Dit simplement, Docker est une machine virtuelle qui émule le système d'exploitation et les librairies mais pas les instructions machine. Ce qui en fait une machine virtuelle très performante.

Docker est très intéressant pour faire tourner un programme dans un environnement logiciels contrôlé avec des versions figées. C'est par exemple le cas pour compiler un BSP en utilisant une vieille distribution linux.

= Compilation du BSP armadeus pour APF27 =

L'APF27 est typiquement la carte qui est encore actuellement en production chez armadeus mais dont le BSP n'est plus utilisable avec les outils actuels. À l'origine, le BSP de l'apf27 était compilé sur des version d'ubuntu datant des années 2010 !

Si l'on veut pouvoir reprendre son projet sans avoir à redémarrer un ordinateur de cette époque, voici comment faire avec docker.
L'exemple de cet article a été réalisé sur une distribution ubuntu version Ubuntu 20.04.3 LTS.

== Lancement de Docker ==

Docker est un «deamon» qu'il faut lancer en tâche de fond sur son système. Sur Ubuntu c'est systemd qui contrôle ça :
<source lang="sh">
$ sudo systemctl start docker
</source>

Une fois que docker tourne en tâche de fond, on peu lancer directement une console `bash` ubuntu version 12.04 avec la commande
<source lang="sh">
$ sudo docker run -it ubuntu:12.04 /bin/bash
root@1a5b88e1759c:/# cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=12.04
DISTRIB_CODENAME=precise
DISTRIB_DESCRIPTION="Ubuntu 12.04.5 LTS"
root@1a5b88e1759c:/#
</source>

Un container existe déjà sur les serveurs docker avec une version minimaliste. En tapant la commande ci-dessus, docker va simplement télécharger le container pour le lancer sur la machine.

Notre shell bash tourne bien dans une distribution ubuntu version 12.04. Pour visualiser les container actifs dans docker on lancera la commande suivant dans une autre console :
<source lang="sh">
$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
1a5b88e1759c ubuntu:12.04 "/bin/bash" 2 minutes ago Up 2 minutes stoic_noether
</source>

Si l'on quitte la console avec `exit`, le container sera mis en inactif et il faudra le relancer pour pouvoir s'y ré-attacher :

<source>
root@1a5b88e1759c:/# exit
exit
$ sudo docker container start stoic_noether
stoic_noether
$ sudo docker attach stoic_noether
root@1a5b88e1759c:/# history
1 ls
2 top
3 cat /etc/lsb-release
4 exit
5 history
root@1a5b88e1759c:/#
</source>

Une fois que l'on se trouve dans la console on peut tenter de télécharger et compiler le bsp armadeus-7.0 par exemple :

<source lang="sh">
root@3264de07ca45:/# cd /opt/
root@3264de07ca45:/opt# mkdir bsp
root@3264de07ca45:/opt# cd bsp/
root@3264de07ca45:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download
bash: wget: command not found
root@3264de07ca45:/opt/bsp# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
E: Unable to locate package wget
root@3264de07ca45:/opt/bsp# apt-get update
Ign http://archive.ubuntu.com precise Release.gpg
[...]
E: Some index files failed to download. They have been ignored, or old ones used instead.
root@3264de07ca45:/opt/bsp#
</source>

Ach! Très vite on se rend compte que la distribution fournie par docker est bien trop minimaliste pour que l'on puisse travailler avec. Nous allons donc devoir construire notre propre container qui partira de cette distribution pour la customiser.

== Construction d'un container ==

Pour construire son propre container, il faut créer un fichier de configuration avec le nom '''Dockerfile'''. Dans lequel on donnera le container de départ :
<source lang="INI">
#Simple commentaire d'entête
FROM ubuntu:12.04

# on ajoute les dépots apt encore accessible aujourd'hui

# Sources from https://gist.github.com/ivomts/4558134
RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
</source>

Et on construit le container en lui donnant un nom et une version :
<source lang="sh">
$ sudo docker build -t apf27bsp:0.1 .
Sending build context to Docker daemon 2.56kB
Step 1/2 : FROM ubuntu:12.04
---> 5b117edd0b76
Step 2/2 : RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
---> Running in 0b854be1e236
Removing intermediate container 0b854be1e236
---> 9c3cb7850267
Successfully built 9c3cb7850267
Successfully tagged apf27bsp:0.1
</source>

Le container ainsi construit peut être lancer avec la commande que l'on connaît bien maintenant :
<source>
$ sudo docker container run -it apf27bsp:0.1 /bin/bash
root@d6f2e3190f9b:/# apt-get update
Get:1 http://old-releases.ubuntu.com precise Release.gpg [198 B]
...
root@d6f2e3190f9b:/# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following extra packages will be installed:
libidn11
The following NEW packages will be installed:
libidn11 wget
0 upgraded, 2 newly installed, 0 to remove and 27 not upgraded.
Need to get 392 kB of archives.
After this operation, 970 kB of additional disk space will be used.
Do you want to continue [Y/n]? y
...
root@d6f2e3190f9b:/# cd /opt/
root@d6f2e3190f9b:/opt# ls
root@d6f2e3190f9b:/opt# mkdir bsp
root@d6f2e3190f9b:/opt# cd bsp/
root@d6f2e3190f9b:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download --no-check-certificate
...
Saving to: `download'

100%[=========================================================================================================================================================================>] 6,572,959 1.87M/s in 3.8s

2022-02-18 15:58:54 (1.67 MB/s) - `download' saved [6572959/6572959]

root@d6f2e3190f9b:/opt/bsp# mv download armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp# apt-get install bzip2
root@d6f2e3190f9b:/opt/bsp# tar jxf armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp#
</source>

Très vite on se rend compte que nous avons beaucoup de logiciels à télécharger et installer. Le problème des containers c'est que rien n'est enregistré, donc à chaque fois qu'on lance le container avec la commande `run` tout est remis à zéro.

Il devient donc indispensable d'ajouter les commandes de mise à jour des packages dans le `Dockerfile`. Heureusement, Armadeus propose un script pour ça dans son BSP comme nous allons le voir par la suite.

== Montage de répertoires «host» ==

Pour récupérer les fichiers que l'on compile avec le container il va être nécessaire de «monter» un répertoire de son ordinateur dans le container.

Ce montage se fait au lancement du container. Par exemple si nous souhaitons monter le répertoire de téléchargement des packets buildroot ainsi que le répertoire du bsp armadeus nous utiliserons la commande :

<source lang="sh">
sudo docker run --mount src=/downloads,target=/downloads,type=bind \
--mount src=/home/user/prj/armadeusbsp,target=/opt/bsp/,type=bind \
-it apf27bsp:1.0 /bin/bash
</source>

Nous mutualiserons ainsi le répertoires /downloads de notre machine et nous récupérerons les binaires générés à la compilation du bsp dans le container.

== Le Dockerfile Armadeus ==

Armadeus fourni le Dockerfile pour compiler l'apf27, il suffit donc de le construire en se rendant dans le répertoire `scripts/docker/apf27-ubuntu-12.04` du bsp. Un fichier README.md donne la marche à suivre pour le construire et le lancer.

2022 02 18 Container docker pour vieux BSP

2022-02-18T16:16:07Z

FabienM: /* Construction d'un container */

= Introduction =

Avec la pénurie de composants actuelle beaucoup d'entreprises sont contraintes de modifier leurs cartes électroniques de manière à supporter des variantes de leurs composants. Ce changement de composants impose souvent de retoucher le logiciel et de «remettre les mains dans le code» archivé depuis belle lurette.
Le temps du développement n'étant pas celui de la production, les projets sont souvent «figés» de longue date. Et les machines qui permettaient de compiler le matériel sont totalement obsolète quand le produit est en «full-prod».

Réinstaller les vieux logiciels qui ont permis de développer le produit se révèle souvent une gageur sur des systèmes actuels.

Heureusement pour Armadeus, tout le développement de ses cartes se fait sous Linux. Et nous avons aujourd'hui un outils formidable pour faire tourner de vieux logiciel sur des systèmes «à jour» : '''la virtualisation légère''', avec notamment le logiciel [https://fr.wikipedia.org/wiki/Docker_(logiciel) docker].

= Docker, la virtualisation légère =

Selon [https://fr.wikipedia.org/wiki/Docker_(logiciel) Wikipedia] Docker est «une plateforme permettant de lancer certaines applications dans des conteneurs logiciels. Docker étend le format de conteneur Linux standard, LXC, avec une API de haut niveau fournissant une solution pratique de virtualisation qui exécute les processus de façon isolée2.»

Dit simplement, Docker est une machine virtuelle qui émule le système d'exploitation et les librairies mais pas les instructions machine. Ce qui en fait une machine virtuelle très performante.

Docker est très intéressant pour faire tourner un programme dans un environnement logiciels contrôlé avec des versions figées. C'est par exemple le cas pour compiler un BSP en utilisant une vieille distribution linux.

= Compilation du BSP armadeus pour APF27 =

L'APF27 est typiquement la carte qui est encore actuellement en production chez armadeus mais dont le BSP n'est plus utilisable avec les outils actuels. À l'origine, le BSP de l'apf27 était compilé sur des version d'ubuntu datant des années 2010 !

Si l'on veut pouvoir reprendre son projet sans avoir à redémarrer un ordinateur de cette époque, voici comment faire avec docker.
L'exemple de cet article a été réalisé sur une distribution ubuntu version Ubuntu 20.04.3 LTS.

== Lancement de Docker ==

Docker est un «deamon» qu'il faut lancer en tâche de fond sur son système. Sur Ubuntu c'est systemd qui contrôle ça :
<source lang="sh">
$ sudo systemctl start docker
</source>

Une fois que docker tourne en tâche de fond, on peu lancer directement une console `bash` ubuntu version 12.04 avec la commande
<source lang="sh">
$ sudo docker run -it ubuntu:12.04 /bin/bash
root@1a5b88e1759c:/# cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=12.04
DISTRIB_CODENAME=precise
DISTRIB_DESCRIPTION="Ubuntu 12.04.5 LTS"
root@1a5b88e1759c:/#
</source>

Un container existe déjà sur les serveurs docker avec une version minimaliste. En tapant la commande ci-dessus, docker va simplement télécharger le container pour le lancer sur la machine.

Notre shell bash tourne bien dans une distribution ubuntu version 12.04. Pour visualiser les container actifs dans docker on lancera la commande suivant dans une autre console :
<source lang="sh">
$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
1a5b88e1759c ubuntu:12.04 "/bin/bash" 2 minutes ago Up 2 minutes stoic_noether
</source>

Si l'on quitte la console avec `exit`, le container sera mis en inactif et il faudra le relancer pour pouvoir s'y ré-attacher :

<source>
root@1a5b88e1759c:/# exit
exit
$ sudo docker container start stoic_noether
stoic_noether
$ sudo docker attach stoic_noether
root@1a5b88e1759c:/# history
1 ls
2 top
3 cat /etc/lsb-release
4 exit
5 history
root@1a5b88e1759c:/#
</source>

Une fois que l'on se trouve dans la console on peut tenter de télécharger et compiler le bsp armadeus-7.0 par exemple :

<source lang="sh">
root@3264de07ca45:/# cd /opt/
root@3264de07ca45:/opt# mkdir bsp
root@3264de07ca45:/opt# cd bsp/
root@3264de07ca45:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download
bash: wget: command not found
root@3264de07ca45:/opt/bsp# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
E: Unable to locate package wget
root@3264de07ca45:/opt/bsp# apt-get update
Ign http://archive.ubuntu.com precise Release.gpg
[...]
E: Some index files failed to download. They have been ignored, or old ones used instead.
root@3264de07ca45:/opt/bsp#
</source>

Ach! Très vite on se rend compte que la distribution fournie par docker est bien trop minimaliste pour que l'on puisse travailler avec. Nous allons donc devoir construire notre propre container qui partira de cette distribution pour la customiser.

== Construction d'un container ==

Pour construire son propre container, il faut créer un fichier de configuration avec le nom '''Dockerfile'''. Dans lequel on donnera le container de départ :
<source lang="INI">
#Simple commentaire d'entête
FROM ubuntu:12.04

# on ajoute les dépots apt encore accessible aujourd'hui

# Sources from https://gist.github.com/ivomts/4558134
RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
</source>

Et on construit le container en lui donnant un nom et une version :
<source lang="sh">
$ sudo docker build -t apf27bsp:0.1 .
Sending build context to Docker daemon 2.56kB
Step 1/2 : FROM ubuntu:12.04
---> 5b117edd0b76
Step 2/2 : RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
---> Running in 0b854be1e236
Removing intermediate container 0b854be1e236
---> 9c3cb7850267
Successfully built 9c3cb7850267
Successfully tagged apf27bsp:0.1
</source>

Le container ainsi construit peut être lancer avec la commande que l'on connaît bien maintenant :
<source>
$ sudo docker container run -it apf27bsp:0.1 /bin/bash
root@d6f2e3190f9b:/# apt-get update
Get:1 http://old-releases.ubuntu.com precise Release.gpg [198 B]
...
root@d6f2e3190f9b:/# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following extra packages will be installed:
libidn11
The following NEW packages will be installed:
libidn11 wget
0 upgraded, 2 newly installed, 0 to remove and 27 not upgraded.
Need to get 392 kB of archives.
After this operation, 970 kB of additional disk space will be used.
Do you want to continue [Y/n]? y
...
root@d6f2e3190f9b:/# cd /opt/
root@d6f2e3190f9b:/opt# ls
root@d6f2e3190f9b:/opt# mkdir bsp
root@d6f2e3190f9b:/opt# cd bsp/
root@d6f2e3190f9b:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download --no-check-certificate
...
Saving to: `download'

100%[=========================================================================================================================================================================>] 6,572,959 1.87M/s in 3.8s

2022-02-18 15:58:54 (1.67 MB/s) - `download' saved [6572959/6572959]

root@d6f2e3190f9b:/opt/bsp# mv download armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp# apt-get install bzip2
root@d6f2e3190f9b:/opt/bsp# tar jxf armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp#
</source>

Très vite on se rend compte que nous avons beaucoup de logiciels à télécharger et installer. Le problème des containers c'est que rien n'est enregistré, donc à chaque fois qu'on lance le container avec la commande `run` tout est remis à zéro.

Il devient donc indispensable d'ajouter les commandes de mise à jour des packages dans le `Dockerfile`. Heureusement, Armadeus propose un script pour ça dans son BSP comme nous allons le voir par la suite.

== Montage de répertoires «host» ==

Pour récupérer les fichiers que l'on compile avec le container il va être nécessaire de «monter» un répertoire de son ordinateur dans le container.

Ce montage se fait au lancement du container. Par exemple si nous souhaitons monter le répertoire de téléchargement des packets buildroot ainsi que le répertoire du bsp armadeus nous utiliserons la commande :

<source lang="sh">
sudo docker run --mount src=/downloads,target=/downloads,type=bind \
--mount src=/home/user/prj/armadeusbsp,target=/opt/bsp/,type=bind \
-it apf27bsp:1.0 /bin/bash
</source>

Nous mutualiserons ainsi le répertoires /downloads de notre machine et nous récupérerons les binaires générés à la compilation du bsp dans le container.

== Le Dockerfile Armadeus ==

Armadeus fourni le Dockerfile pour compiler l'apf27, il suffit donc de le construire en se rendant dans le répertoire `??` du bsp. Un fichier README.md donne la marche à suivre pour le construire et le lancer.

2022 02 18 Container docker pour vieux BSP

2022-02-18T16:15:13Z

FabienM: /* Construction d'un container */

= Introduction =

Avec la pénurie de composants actuelle beaucoup d'entreprises sont contraintes de modifier leurs cartes électroniques de manière à supporter des variantes de leurs composants. Ce changement de composants impose souvent de retoucher le logiciel et de «remettre les mains dans le code» archivé depuis belle lurette.
Le temps du développement n'étant pas celui de la production, les projets sont souvent «figés» de longue date. Et les machines qui permettaient de compiler le matériel sont totalement obsolète quand le produit est en «full-prod».

Réinstaller les vieux logiciels qui ont permis de développer le produit se révèle souvent une gageur sur des systèmes actuels.

Heureusement pour Armadeus, tout le développement de ses cartes se fait sous Linux. Et nous avons aujourd'hui un outils formidable pour faire tourner de vieux logiciel sur des systèmes «à jour» : '''la virtualisation légère''', avec notamment le logiciel [https://fr.wikipedia.org/wiki/Docker_(logiciel) docker].

= Docker, la virtualisation légère =

Selon [https://fr.wikipedia.org/wiki/Docker_(logiciel) Wikipedia] Docker est «une plateforme permettant de lancer certaines applications dans des conteneurs logiciels. Docker étend le format de conteneur Linux standard, LXC, avec une API de haut niveau fournissant une solution pratique de virtualisation qui exécute les processus de façon isolée2.»

Dit simplement, Docker est une machine virtuelle qui émule le système d'exploitation et les librairies mais pas les instructions machine. Ce qui en fait une machine virtuelle très performante.

Docker est très intéressant pour faire tourner un programme dans un environnement logiciels contrôlé avec des versions figées. C'est par exemple le cas pour compiler un BSP en utilisant une vieille distribution linux.

= Compilation du BSP armadeus pour APF27 =

L'APF27 est typiquement la carte qui est encore actuellement en production chez armadeus mais dont le BSP n'est plus utilisable avec les outils actuels. À l'origine, le BSP de l'apf27 était compilé sur des version d'ubuntu datant des années 2010 !

Si l'on veut pouvoir reprendre son projet sans avoir à redémarrer un ordinateur de cette époque, voici comment faire avec docker.
L'exemple de cet article a été réalisé sur une distribution ubuntu version Ubuntu 20.04.3 LTS.

== Lancement de Docker ==

Docker est un «deamon» qu'il faut lancer en tâche de fond sur son système. Sur Ubuntu c'est systemd qui contrôle ça :
<source lang="sh">
$ sudo systemctl start docker
</source>

Une fois que docker tourne en tâche de fond, on peu lancer directement une console `bash` ubuntu version 12.04 avec la commande
<source lang="sh">
$ sudo docker run -it ubuntu:12.04 /bin/bash
root@1a5b88e1759c:/# cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=12.04
DISTRIB_CODENAME=precise
DISTRIB_DESCRIPTION="Ubuntu 12.04.5 LTS"
root@1a5b88e1759c:/#
</source>

Un container existe déjà sur les serveurs docker avec une version minimaliste. En tapant la commande ci-dessus, docker va simplement télécharger le container pour le lancer sur la machine.

Notre shell bash tourne bien dans une distribution ubuntu version 12.04. Pour visualiser les container actifs dans docker on lancera la commande suivant dans une autre console :
<source lang="sh">
$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
1a5b88e1759c ubuntu:12.04 "/bin/bash" 2 minutes ago Up 2 minutes stoic_noether
</source>

Si l'on quitte la console avec `exit`, le container sera mis en inactif et il faudra le relancer pour pouvoir s'y ré-attacher :

<source>
root@1a5b88e1759c:/# exit
exit
$ sudo docker container start stoic_noether
stoic_noether
$ sudo docker attach stoic_noether
root@1a5b88e1759c:/# history
1 ls
2 top
3 cat /etc/lsb-release
4 exit
5 history
root@1a5b88e1759c:/#
</source>

Une fois que l'on se trouve dans la console on peut tenter de télécharger et compiler le bsp armadeus-7.0 par exemple :

<source lang="sh">
root@3264de07ca45:/# cd /opt/
root@3264de07ca45:/opt# mkdir bsp
root@3264de07ca45:/opt# cd bsp/
root@3264de07ca45:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download
bash: wget: command not found
root@3264de07ca45:/opt/bsp# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
E: Unable to locate package wget
root@3264de07ca45:/opt/bsp# apt-get update
Ign http://archive.ubuntu.com precise Release.gpg
[...]
E: Some index files failed to download. They have been ignored, or old ones used instead.
root@3264de07ca45:/opt/bsp#
</source>

Ach! Très vite on se rend compte que la distribution fournie par docker est bien trop minimaliste pour que l'on puisse travailler avec. Nous allons donc devoir construire notre propre container qui partira de cette distribution pour la customiser.

== Construction d'un container ==

Pour construire son propre container, il faut créer un fichier de configuration avec le nom '''Dockerfile'''. Dans lequel on donnera le container de départ :
<source lang="INI">
#Simple commentaire d'entête
FROM ubuntu:12.04

# on ajoute les dépots apt encore accessible aujourd'hui

# Sources from https://gist.github.com/ivomts/4558134
RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
</source>

Et on construit le container en lui donnant un nom et une version :
<source lang="sh">
$ sudo docker build -t apf27bsp:0.1 .
Sending build context to Docker daemon 2.56kB
Step 1/2 : FROM ubuntu:12.04
---> 5b117edd0b76
Step 2/2 : RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
---> Running in 0b854be1e236
Removing intermediate container 0b854be1e236
---> 9c3cb7850267
Successfully built 9c3cb7850267
Successfully tagged apf27bsp:0.1
</source>

Le container ainsi construit peut être lancer avec la commande que l'on connaît bien maintenant :
<source>
$ sudo docker container run -it apf27bsp:0.1 /bin/bash
root@d6f2e3190f9b:/# apt-get update
Get:1 http://old-releases.ubuntu.com precise Release.gpg [198 B]
...
root@d6f2e3190f9b:/# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following extra packages will be installed:
libidn11
The following NEW packages will be installed:
libidn11 wget
0 upgraded, 2 newly installed, 0 to remove and 27 not upgraded.
Need to get 392 kB of archives.
After this operation, 970 kB of additional disk space will be used.
Do you want to continue [Y/n]? y
...
root@d6f2e3190f9b:/# cd /opt/
root@d6f2e3190f9b:/opt# ls
root@d6f2e3190f9b:/opt# mkdir bsp
root@d6f2e3190f9b:/opt# cd bsp/
root@d6f2e3190f9b:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download --no-check-certificate
...
Saving to: `download'

100%[=========================================================================================================================================================================>] 6,572,959 1.87M/s in 3.8s

2022-02-18 15:58:54 (1.67 MB/s) - `download' saved [6572959/6572959]

root@d6f2e3190f9b:/opt/bsp# mv download armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp# apt-get install bzip2
root@d6f2e3190f9b:/opt/bsp# tar jxf armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp#
</source>

Très vite on se rend compte que nous avons beaucoup de logiciel à télécharger et installer. Le problème des container c'est que rien n'est enregistré, donc à chaque fois qu'on lance le container avec la commande `run` tout est remis à zéro.

Il devient donc rapidement indispensable d'ajouter les commande de mise à jour des packages dans le `Dockerfile`. Heureusement, Armadeus propose un script pour ça dans son BSP comme nous allons le voir par la suite.

== Montage de répertoires «host» ==

Pour récupérer les fichiers que l'on compile avec le container il va être nécessaire de «monter» un répertoire de son ordinateur dans le container.

Ce montage se fait au lancement du container. Par exemple si nous souhaitons monter le répertoire de téléchargement des packets buildroot ainsi que le répertoire du bsp armadeus nous utiliserons la commande :

<source lang="sh">
sudo docker run --mount src=/downloads,target=/downloads,type=bind \
--mount src=/home/user/prj/armadeusbsp,target=/opt/bsp/,type=bind \
-it apf27bsp:1.0 /bin/bash
</source>

Nous mutualiserons ainsi le répertoires /downloads de notre machine et nous récupérerons les binaires générés à la compilation du bsp dans le container.

== Le Dockerfile Armadeus ==

Armadeus fourni le Dockerfile pour compiler l'apf27, il suffit donc de le construire en se rendant dans le répertoire `??` du bsp. Un fichier README.md donne la marche à suivre pour le construire et le lancer.

2022 02 18 Container docker pour vieux BSP

2022-02-18T16:07:08Z

FabienM: /* Construction d'un container */

= Introduction =

Avec la pénurie de composants actuelle beaucoup d'entreprises sont contraintes de modifier leurs cartes électroniques de manière à supporter des variantes de leurs composants. Ce changement de composants impose souvent de retoucher le logiciel et de «remettre les mains dans le code» archivé depuis belle lurette.
Le temps du développement n'étant pas celui de la production, les projets sont souvent «figés» de longue date. Et les machines qui permettaient de compiler le matériel sont totalement obsolète quand le produit est en «full-prod».

Réinstaller les vieux logiciels qui ont permis de développer le produit se révèle souvent une gageur sur des systèmes actuels.

Heureusement pour Armadeus, tout le développement de ses cartes se fait sous Linux. Et nous avons aujourd'hui un outils formidable pour faire tourner de vieux logiciel sur des systèmes «à jour» : '''la virtualisation légère''', avec notamment le logiciel [https://fr.wikipedia.org/wiki/Docker_(logiciel) docker].

= Docker, la virtualisation légère =

Selon [https://fr.wikipedia.org/wiki/Docker_(logiciel) Wikipedia] Docker est «une plateforme permettant de lancer certaines applications dans des conteneurs logiciels. Docker étend le format de conteneur Linux standard, LXC, avec une API de haut niveau fournissant une solution pratique de virtualisation qui exécute les processus de façon isolée2.»

Dit simplement, Docker est une machine virtuelle qui émule le système d'exploitation et les librairies mais pas les instructions machine. Ce qui en fait une machine virtuelle très performante.

Docker est très intéressant pour faire tourner un programme dans un environnement logiciels contrôlé avec des versions figées. C'est par exemple le cas pour compiler un BSP en utilisant une vieille distribution linux.

= Compilation du BSP armadeus pour APF27 =

L'APF27 est typiquement la carte qui est encore actuellement en production chez armadeus mais dont le BSP n'est plus utilisable avec les outils actuels. À l'origine, le BSP de l'apf27 était compilé sur des version d'ubuntu datant des années 2010 !

Si l'on veut pouvoir reprendre son projet sans avoir à redémarrer un ordinateur de cette époque, voici comment faire avec docker.
L'exemple de cet article a été réalisé sur une distribution ubuntu version Ubuntu 20.04.3 LTS.

== Lancement de Docker ==

Docker est un «deamon» qu'il faut lancer en tâche de fond sur son système. Sur Ubuntu c'est systemd qui contrôle ça :
<source lang="sh">
$ sudo systemctl start docker
</source>

Une fois que docker tourne en tâche de fond, on peu lancer directement une console `bash` ubuntu version 12.04 avec la commande
<source lang="sh">
$ sudo docker run -it ubuntu:12.04 /bin/bash
root@1a5b88e1759c:/# cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=12.04
DISTRIB_CODENAME=precise
DISTRIB_DESCRIPTION="Ubuntu 12.04.5 LTS"
root@1a5b88e1759c:/#
</source>

Un container existe déjà sur les serveurs docker avec une version minimaliste. En tapant la commande ci-dessus, docker va simplement télécharger le container pour le lancer sur la machine.

Notre shell bash tourne bien dans une distribution ubuntu version 12.04. Pour visualiser les container actifs dans docker on lancera la commande suivant dans une autre console :
<source lang="sh">
$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
1a5b88e1759c ubuntu:12.04 "/bin/bash" 2 minutes ago Up 2 minutes stoic_noether
</source>

Si l'on quitte la console avec `exit`, le container sera mis en inactif et il faudra le relancer pour pouvoir s'y ré-attacher :

<source>
root@1a5b88e1759c:/# exit
exit
$ sudo docker container start stoic_noether
stoic_noether
$ sudo docker attach stoic_noether
root@1a5b88e1759c:/# history
1 ls
2 top
3 cat /etc/lsb-release
4 exit
5 history
root@1a5b88e1759c:/#
</source>

Une fois que l'on se trouve dans la console on peut tenter de télécharger et compiler le bsp armadeus-7.0 par exemple :

<source lang="sh">
root@3264de07ca45:/# cd /opt/
root@3264de07ca45:/opt# mkdir bsp
root@3264de07ca45:/opt# cd bsp/
root@3264de07ca45:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download
bash: wget: command not found
root@3264de07ca45:/opt/bsp# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
E: Unable to locate package wget
root@3264de07ca45:/opt/bsp# apt-get update
Ign http://archive.ubuntu.com precise Release.gpg
[...]
E: Some index files failed to download. They have been ignored, or old ones used instead.
root@3264de07ca45:/opt/bsp#
</source>

Ach! Très vite on se rend compte que la distribution fournie par docker est bien trop minimaliste pour que l'on puisse travailler avec. Nous allons donc devoir construire notre propre container qui partira de cette distribution pour la customiser.

== Construction d'un container ==

Pour construire son propre container, il faut créer un fichier de configuration avec le nom '''Dockerfile'''. Dans lequel on donnera le container de départ :
<source lang="INI">
#Simple commentaire d'entête
FROM ubuntu:12.04

# on ajoute les dépots apt encore accessible aujourd'hui

# Sources from https://gist.github.com/ivomts/4558134
RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && \
echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && \
echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
</source>

Et on construit le container en lui donnant un nom et une version :
<source lang="sh">
$ sudo docker build -t apf27bsp:0.1 .
Sending build context to Docker daemon 2.56kB
Step 1/2 : FROM ubuntu:12.04
---> 5b117edd0b76
Step 2/2 : RUN echo "deb http://old-releases.ubuntu.com/ubuntu/ precise main restricted" > /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise main restricted" >> /etc/apt/sources.list && echo "deb http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list && echo "deb-src http://old-releases.ubuntu.com/ubuntu/ precise-updates main restricted" >> /etc/apt/sources.list
---> Running in 0b854be1e236
Removing intermediate container 0b854be1e236
---> 9c3cb7850267
Successfully built 9c3cb7850267
Successfully tagged apf27bsp:0.1
</source>

Le container ainsi construit peut être lancer avec la commande que l'on connaît bien maintenant :
<source>
$ sudo docker container run -it apf27bsp:0.1 /bin/bash
root@d6f2e3190f9b:/# apt-get update
Get:1 http://old-releases.ubuntu.com precise Release.gpg [198 B]
...
root@d6f2e3190f9b:/# apt-get install wget
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following extra packages will be installed:
libidn11
The following NEW packages will be installed:
libidn11 wget
0 upgraded, 2 newly installed, 0 to remove and 27 not upgraded.
Need to get 392 kB of archives.
After this operation, 970 kB of additional disk space will be used.
Do you want to continue [Y/n]? y
...
root@d6f2e3190f9b:/# cd /opt/
root@d6f2e3190f9b:/opt# ls
root@d6f2e3190f9b:/opt# mkdir bsp
root@d6f2e3190f9b:/opt# cd bsp/
root@d6f2e3190f9b:/opt/bsp# wget https://sourceforge.net/projects/armadeus/files/armadeus/armadeus-7.0/armadeus-7.0.tar.bz2/download --no-check-certificate
...
Saving to: `download'

100%[=========================================================================================================================================================================>] 6,572,959 1.87M/s in 3.8s

2022-02-18 15:58:54 (1.67 MB/s) - `download' saved [6572959/6572959]

root@d6f2e3190f9b:/opt/bsp# mv download armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp# apt-get install bzip2
root@d6f2e3190f9b:/opt/bsp# tar jxf armadeus-7.0.tar.bz2
root@d6f2e3190f9b:/opt/bsp#
</source>

Très vite on se rend compte que nous avons beaucoup de logiciel à télécharger et installer. Le problème des container c'est que rien n'est enregistré, donc à chaque fois qu'on lance le containert avec la commande `run` tout est remis à zéro.

Il devient donc rapidement indispensable d'ajouter les commande de mise à jour des packages dans le `Dockerfile`. Et pour récupérer les fichiers que l'on compile avec le container il va être nécessaire de «monter» un répertoire de son ordinateur dans le container.

Ce montage se fait au lancement du container. Par exemple si nous souhaitons monter le répertoire de téléchargement des packets buildroot ainsi que le répertoire du bsp armadeus nous utiliserons la commande :

<source lang="sh">
sudo docker run --mount src=/downloads,target=/downloads,type=bind \
--mount src=/home/user/prj/armadeusbsp,target=/opt/bsp/,type=bind \
-it apf27bsp:1.0 /bin/bash
</source>

Nous mutualiserons ainsi le répertoires /downloads de notre machine et nous récupérerons les binaires générés à la compilation du bsp dans le container.

2022 02 18 Container docker pour vieux BSP

2022-02-18T15:52:53Z

FabienM: /* Lancement de Docker */

2022 02 18 Container docker pour vieux BSP

2022-02-18T15:45:31Z

FabienM: /* Lancement de Docker */

2022 02 18 Container docker pour vieux BSP

2022-02-18T15:26:35Z

FabienM: /* Lancement de Docker */

2022 02 18 Container docker pour vieux BSP

2022-02-18T15:26:01Z

FabienM: /* Compilation du BSP armadeus pour APF27 */

2022 02 18 Container docker pour vieux BSP

2022-02-18T15:06:40Z

FabienM: Created page with "= Introduction = Avec la pénurie de composants actuelle beaucoup d'entreprises sont contraintes de modifier leurs cartes électroniques de manière à supporter des variante..."

User:FabienM

2022-02-18T14:40:59Z

FabienM: /* Blog */

[[MemberList | << liste des membres]]

= Mes petites bidouilles avec l'armadeus =

* [[Une led qui clignote avec le spartan 3]]
* [[Petits trucs en vrac]]
* [[Led sensor]]
* [[vim | The best editor in the world]]

= Trucs =

== Python en environnement virtuel ==

Un pense bète pour installer la version voulue de python en environnement virtuel avec virtualenv:

=== virtualenv et autre tkinter ===

<pre>
apt-get install python-tk python3-tk tk-dev
apt-get install python-virtualenv
</pre>

=== Python 3.7.4 ===

<pre>
sudo apt-get install libffi-dev
wget https://www.python.org/ftp/python/3.7.4/Python-3.7.4.tar.xz
tar -Jxvf Python-3.7.4.tar.xz
cd Python-3.7.4
./configure --enable-shared
make
sudo make install
sudo ldconfig /usr/local/lib
</pre>

=== virtualenv ===

* Virtual env configuration:

<pre>
apt-get install python-virtualenv
mkdir virtenv
cd virtenv
virtualenv --python=/usr/local/bin/python3.7 envp37
</pre>

* enum bug fix:

<pre>
cd ~/virtenv/envp37/lib/python3.7
ln -s /usr/local/lib/python3.7/enum.py
</pre>

* Activation:
<pre>
source /home/armadeus/virtenv/envp37/bin/activate
</pre>

* Desactivation:
<pre>
deactivate
</pre>

= '''P'''eripheral '''O'''n '''D'''emand =

* [[Specification feedback]]

= Participation à la documentation ArmadeuS Project =

* [[How to make a VHDL design in Ubuntu/Debian]]
* [[How to simulate post synthesis and post place & route design with GHDL]]

* [[Using FPGA]]

* [[A simple design with Wishbone bus]]

* [[How to use kernel 2.6.38.x on APF27]]

== Trash ==
* [[APF27_FPGA-IMX_interface_description | Description of FPGA-IMX interface for APF27]]
* [[APF51_FPGA-IMX_interface_description | Description of FPGA-IMX interface for APF51]]
* [[FPGA | FPGA on APF introduction]]
* [[FPGA and led | Button and LED]]

== Projets ==

* Camera [[C38A]] with chip ov7620
* Camera omnivision [[VC21CC1]]
* [[Robotic]]
* [[Home monitoring energy | Compteur d'énergie électrique]]
* [[OOCP]] (Only One Cable Project)
* [[Use MySQL-client on apf9328]]
* [[Light-APF27Dev | Light-APF27Dev project ]]

= Liens utiles =

* Projets [http://sourceforge.net/projects/armadeus sourceforge]
* Site [http://www.armadeus.com/english/index.html entreprise]
* Les codes de retour d'erreurs : http://www.opengroup.org/onlinepubs/007908799/xsh/errno.h.html
* [[Buildroot_Packages]]
* [http://sebsauvage.net/files/20130426_cpp_quovadis2013cppontheweb-130425105424-phpapp01.pdf Un papier très intéressant] d'un développeur de jeux vidéo prônant l'utilisation du C++ ... pour le web. Notamment grâce à l'utilisation de [http://sebsauvage.net/files/20130426_cpp_multiplatformconthewebwithemscripten-130405172545-phpapp01.pdf emscripten] qui permet de compiler du C++ vers le javascript (HTML5).

= Somes usefull tricks =
== press a button ==
Here, function to «press enter to continue» on apf in different languages :

<source lang="bash">
setbit /proc/driver/gpio/portFmode 13 1 # set pin as gpio
setbit /proc/driver/gpio/portFdir 13 0 # set pin as input
setbit /proc/driver/gpio/portFirq 13 1 # irq on rising edge

/usr/bin/testsuite/testbutton /dev/gpio/PF13 3
</source>

With ''testbutton'' program comming from
''target/linux/modules/fpga/wishbone_example/wb_button''. Type «make» in this
directory to compile it.

== Logging with timestamps in seconds ==

<source lang="bash">
#!/bin/sh
while true
do
LIGHT=$(cat /sys/class/hwmon/hwmon0/device/in3_input)
TIME=$(date +%s)
echo $TIME", sec, "$LIGHT", mV," >> log;
sleep 2
done
</source>

== Press enter to continue ==
=== C ===

<source lang="C">
#include <stdio.h>

void pressEnterToContinue(void)
{
printf("Press enter to continue\n");
getc(stdin);//XXX
while( getc(stdin) != '\n') ;
}

</source>

=== C++ ===
<source lang="C">
#include <stdio.h> //XXX
#include <iostream>

void pressEnterToContinue(void)
{
cout << "Press enter to continue" << endl;
getc(stdin); //XXX
std::cin.ignore( std::numeric_limits <std::streamsize> ::max(), '\n' );
}

</source>

=== Python 2 ===

<source lang="python">

def pressEnterToContinue():
print "Press enter to continue"
raw_input()

</source>

=== Python 3 ===

<source lang="python">

def pressEnterToContinue():
print("Press enter to continue")
input()

</source>

= Kernel Driver =

* [[IIO kernel driver model]]
* [[UIO kernel driver model]]

= bac à sable =
[[Image:dessin.svg]]

* [[APF6_SP_DDR3_PINOUT]]
* [[APF6_SP The full howto]]

== Wavedrom ==

If [https://github.com/Martoni/mediawiki_wavedrom wavedrom plugin] is installed on this wiki, we can see a beautiful waves bellow :

<wavedrom>
{ signal: [
{ name: "clk", wave: "p......" },
{ name: "bus", wave: "x.34.5x", data: "head body tail" },
{ name: "wire", wave: "0.1..0." },
]}
</wavedrom>

= Blog =

* [[2022_02_18_Container_docker_pour_vieux_BSP]]

User:FabienM

2022-02-18T14:29:16Z

FabienM:

Serial Transfer

2022-02-01T16:31:42Z

FabienM: /* Microcom */

Instructions to use the serial port of your Armadeus board to transfer files from/to your PC.
{{Note|This page explains how to transfer files on the board when the Linux system has started, '''not from U-Boot !'''.
To know how to configure serial link for U-Boot communication, [[Connection_with_U-Boot_on_Linux|it's here]].}}

==Introduction==

When you only have a serial link (RS232/USB) as connection with your devt PC (ie no Ethernet available), then you can use Zmodem protocol to send/receive files to/from your Shell/Console of your Armadeus board.

== Linux ==

===Installation===

====Target (APF)====
Modify your Buildroot configuration:
<pre class="host">
$ make menuconfig
</pre>
to add lrzsz package:
<pre class="config">
Package Selection for the target --->
Networking applications --->
[*] lrzsz
</pre>
and then rebuild your rootfs:
<pre class="host">
$ make
</pre>

Reflash it or manually copy ''rz'' and ''sz'' executables found in ''$ARMADEUS_ROOTFS_DIR/usr/bin/''.

====Host====
* Install lrzsz package, if not already installed on your system. For example on Ubuntu/Debian:
<pre class="host">
$ sudo apt-get install lrzsz
</pre>
* Install minicom tool:
<pre class="host">
$ sudo apt-get install minicom
</pre>
* The first time, configure minicom (as root):
<pre class="host">
$ sudo minicom -s
</pre>

===Usage===

{{Warning| You must use [[minicom]] as serial terminal and not [[kermit]]/[[screen]], sorry ! :-(}}
* Be sure to have correctly configured Minicom (line speed, 8N1, no flow control, and correct download/upload directories path).
* Use '''rz''' for receiving and '''sz''' to send files:
====Host (PC) --> Target (APF)====
<pre class="apf">
# cd /whereToPutTheFileOnTheTarget/
# rz -bZ
.. waiting to receive.
</pre>
* then in minicom do: '''Ctrl+a , s''' and choose zmodem protocol and the file to send.
* Wait a little and your file will be copied to your board rootfs ! ;-)

====Target (APF) --> Host (PC)====
<pre class="apf">
# cd /location/of_the/file_to_send/on_the_apf/
# sz -b --zmodem filename
</pre>
Minicom handles the file receiving automatically (and put it in your $HOME by default, or the directory you configured in Minicom: Ctrl+z, o, ''Filenames and paths'', ''Download directory'')

===TBDL===
====Serial transfer through USB gadget as serial link====
After having booted your board:
* On your Target, open a new terminal on your serial link (here USB):
<pre class="apf">
# /sbin/getty -L ttygserial 115200 vt100
</pre>
* On your Host, launch Minicom and configure it to use ''/dev/ttyUSB1'' at 115200, then connect it to this terminal

===Transfer without terminal===
* On your Target, launch receiving:
<pre class="apf">
# rz --zmodem 1>/dev/ttyXXX 0</dev/ttyXXX
</pre>
* On your Host, launch transfer:
<pre class="host">
$ sz --zmodem /tftpboot/afiletosend 1>/dev/ttyUSB1 0</dev/ttyUSB1
</pre>

== UBoot ==

=== Minicom ===

With [[minicom]] use ymodem :

* type:
<pre class="apf">
BIOS> loady ${loadaddr}
Ctrl+A Z
</pre>
* Select ymodem then filename

==Links==
* http://www.ohse.de/uwe/software/lrzsz.html

[[Category:Serial ports]]

Serial Transfer

2022-02-01T16:30:53Z

FabienM: /* Linux */

Instructions to use the serial port of your Armadeus board to transfer files from/to your PC.
{{Note|This page explains how to transfer files on the board when the Linux system has started, '''not from U-Boot !'''.
To know how to configure serial link for U-Boot communication, [[Connection_with_U-Boot_on_Linux|it's here]].}}

==Introduction==

When you only have a serial link (RS232/USB) as connection with your devt PC (ie no Ethernet available), then you can use Zmodem protocol to send/receive files to/from your Shell/Console of your Armadeus board.

== Linux ==

===Installation===

====Target (APF)====
Modify your Buildroot configuration:
<pre class="host">
$ make menuconfig
</pre>
to add lrzsz package:
<pre class="config">
Package Selection for the target --->
Networking applications --->
[*] lrzsz
</pre>
and then rebuild your rootfs:
<pre class="host">
$ make
</pre>

Reflash it or manually copy ''rz'' and ''sz'' executables found in ''$ARMADEUS_ROOTFS_DIR/usr/bin/''.

====Host====
* Install lrzsz package, if not already installed on your system. For example on Ubuntu/Debian:
<pre class="host">
$ sudo apt-get install lrzsz
</pre>
* Install minicom tool:
<pre class="host">
$ sudo apt-get install minicom
</pre>
* The first time, configure minicom (as root):
<pre class="host">
$ sudo minicom -s
</pre>

===Usage===

{{Warning| You must use [[minicom]] as serial terminal and not [[kermit]]/[[screen]], sorry ! :-(}}
* Be sure to have correctly configured Minicom (line speed, 8N1, no flow control, and correct download/upload directories path).
* Use '''rz''' for receiving and '''sz''' to send files:
====Host (PC) --> Target (APF)====
<pre class="apf">
# cd /whereToPutTheFileOnTheTarget/
# rz -bZ
.. waiting to receive.
</pre>
* then in minicom do: '''Ctrl+a , s''' and choose zmodem protocol and the file to send.
* Wait a little and your file will be copied to your board rootfs ! ;-)

====Target (APF) --> Host (PC)====
<pre class="apf">
# cd /location/of_the/file_to_send/on_the_apf/
# sz -b --zmodem filename
</pre>
Minicom handles the file receiving automatically (and put it in your $HOME by default, or the directory you configured in Minicom: Ctrl+z, o, ''Filenames and paths'', ''Download directory'')

===TBDL===
====Serial transfer through USB gadget as serial link====
After having booted your board:
* On your Target, open a new terminal on your serial link (here USB):
<pre class="apf">
# /sbin/getty -L ttygserial 115200 vt100
</pre>
* On your Host, launch Minicom and configure it to use ''/dev/ttyUSB1'' at 115200, then connect it to this terminal

===Transfer without terminal===
* On your Target, launch receiving:
<pre class="apf">
# rz --zmodem 1>/dev/ttyXXX 0</dev/ttyXXX
</pre>
* On your Host, launch transfer:
<pre class="host">
$ sz --zmodem /tftpboot/afiletosend 1>/dev/ttyUSB1 0</dev/ttyUSB1
</pre>

== UBoot ==

=== Microcom ===

With [[microcom]] use ymodem :

* type:
<pre class="apf">
BIOS> loady ${loadaddr}
Ctrl+A Z
</pre>
* Select ymodem then filename

==Links==
* http://www.ohse.de/uwe/software/lrzsz.html

[[Category:Serial ports]]

Serial Transfer

2022-02-01T16:29:14Z

FabienM:

Instructions to use the serial port of your Armadeus board to transfer files from/to your PC.
{{Note|This page explains how to transfer files on the board when the Linux system has started, '''not from U-Boot !'''.
To know how to configure serial link for U-Boot communication, [[Connection_with_U-Boot_on_Linux|it's here]].}}

==Introduction==

When you only have a serial link (RS232/USB) as connection with your devt PC (ie no Ethernet available), then you can use Zmodem protocol to send/receive files to/from your Shell/Console of your Armadeus board.

== Linux ==

===Installation===

====Target (APF)====
Modify your Buildroot configuration:
<pre class="host">
$ make menuconfig
</pre>
to add lrzsz package:
<pre class="config">
Package Selection for the target --->
Networking applications --->
[*] lrzsz
</pre>
and then rebuild your rootfs:
<pre class="host">
$ make
</pre>

Reflash it or manually copy ''rz'' and ''sz'' executables found in ''$ARMADEUS_ROOTFS_DIR/usr/bin/''.

====Host====
* Install lrzsz package, if not already installed on your system. For example on Ubuntu/Debian:
<pre class="host">
$ sudo apt-get install lrzsz
</pre>
* Install minicom tool:
<pre class="host">
$ sudo apt-get install minicom
</pre>
* The first time, configure minicom (as root):
<pre class="host">
$ sudo minicom -s
</pre>

===Usage===

{{Warning| You must use [[minicom]] as serial terminal and not [[kermit]]/[[screen]], sorry ! :-(}}
* Be sure to have correctly configured Minicom (line speed, 8N1, no flow control, and correct download/upload directories path).
* Use '''rz''' for receiving and '''sz''' to send files:
====Host (PC) --> Target (APF)====
<pre class="apf">
# cd /whereToPutTheFileOnTheTarget/
# rz -bZ
.. waiting to receive.
</pre>
* then in minicom do: '''Ctrl+a , s''' and choose zmodem protocol and the file to send.
* Wait a little and your file will be copied to your board rootfs ! ;-)

====Target (APF) --> Host (PC)====
<pre class="apf">
# cd /location/of_the/file_to_send/on_the_apf/
# sz -b --zmodem filename
</pre>
Minicom handles the file receiving automatically (and put it in your $HOME by default, or the directory you configured in Minicom: Ctrl+z, o, ''Filenames and paths'', ''Download directory'')

===TBDL===
====Serial transfer through USB gadget as serial link====
After having booted your board:
* On your Target, open a new terminal on your serial link (here USB):
<pre class="apf">
# /sbin/getty -L ttygserial 115200 vt100
</pre>
* On your Host, launch Minicom and configure it to use ''/dev/ttyUSB1'' at 115200, then connect it to this terminal

===Transfer without terminal===
* On your Target, launch receiving:
<pre class="apf">
# rz --zmodem 1>/dev/ttyXXX 0</dev/ttyXXX
</pre>
* On your Host, launch transfer:
<pre class="host">
$ sz --zmodem /tftpboot/afiletosend 1>/dev/ttyUSB1 0</dev/ttyUSB1
</pre>

==Links==
* http://www.ohse.de/uwe/software/lrzsz.html

[[Category:Serial ports]]

ISE WebPack installation on Linux

2022-01-20T09:57:16Z

FabienM: /* ISE 14.7 tips */

[[Category: FPGA]]
==Xilinx WebPack installation instructions for Linux Ubuntu (6.10) with ISE 10.1.==

{{Note|Tested on:
* Ubuntu Dapper (6.10) & Gusty (7.10) x86 32bits,
* KUbuntu 7.10 x86 32bits
}}
=== Packages needed ===
Install following package before installing ISE:
<pre class="host">
$ sudo apt-get install libstdc++5 libmotif4 libxp6 libcurl3
</pre>

=== Instructions ===
{{Note|On new version of ISE webpack '''tcl console''' is not activated by default. To use it check the menu '''View->Panels->Tcl Console'''}}
* download '''ISE WebPACK - WebInstall / ISE WebPACK 10.1 (Free Download)''' archive [http://www.xilinx.com/ise/logic_design_prod/webpack.htm from here]. You will need to create a Xilinx's account and register before being able to download files (it's free).
* Choose the full download version "Download Files Individually" (2,4 Gbytes). When asked, you are not obliged to accept Java download manager (if you are sure of your Internet connection quality). '''Note the registration ID, it will be asked later during installation.'''
[[Image:ISE_full_download.png]]
* You will get a ''webpack_SFD.tar'' archive, save it in your ''$HOME'' dir
* unzip the archive:
<pre class="host">
$ cd $HOME
$ tar xvf webpack_SFD.tar
</pre>
* launch the installation
<pre class="host">
$ cd webpack
$ ./setup
</pre>
* Follows the instructions of the graphical interface (you need to launch setup as root if you want to install JTAG tools '''but on Armadeus JTAG tools are not needed to program the FPGA'''):
[[Image:ISE_install_select.png]]
 
[[Image:ISE_install_dir.png]]
 
[[Image:ISE_install_options.png]]
 
[[Image:ISE_install_options2.png]]
 
[[Image:ISE_install_update.png]]

== Installation guide for debian Wheezy (intel i5 64bits) and ISE 14.6 ==

* with a 64bits (amd64 on debian) first configure i386 compatibility:
<pre class="host">
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install ia32-libs ia32-libs-gtk
</pre>

* Following package must then be installed :

<pre class="host">
sudo apt-get install libstdc++5 libxp6 libcurl3 libmotif4
sudo apt-get install libstdc++5:i386 libxp6:i386 libcurl3:i386 libmotif4:i386
</pre>

* Download «ISE Design Suite - 14.6 Full Product Installation» on [http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/design-tools.html xilinx website] (7.3Go !)

* decompress the tar archive with following command:

<pre class="host">
tar xvf Xilinx_ISE_DS_14.6_P.68d_3.tar
</pre>

* launch installer :

<pre class="host">
cd Xilinx_ISE_DS_14.6_P.68d_3
./xsetup
</pre>

* accept all conditions
* select ''ISE WebPACK'' under menu '''Select Products to Install'''.
* keep default settings
* Give a directory where you have enough space (1.6Go).
* click on '''Install''' button
* get a free license on [http://www.xilinx.com/getlicense this page].

* Go to the directory ISE/ then create the following shell script named '''launchISE''':
<source lang="bash">
source ../ISE/14.6/ISE_DS/settings32.sh
cd ../ISE/14.6/ISE_DS/ISE/bin/lin/
./ise
</source>

* Give rights :
<pre class="host">
chmod 777 launchISE
</pre>

* Then launch it:
<pre class="host">
./launchISE
</pre>

* Enjoy the power of Xilinx tools.

* To add tcl console : View -> Panels -> Tcl Console

{{Note| For [[Migen]], you can also export xilinx path in your '''~/.bashrc''' file :
<source lang="bash">
export XILINX=/opt/Xilinx/14.7/ISE_DS/ISE/
export PATH=$PATH:${XILINX}/bin/lin
</source>
}}

== ISE 14.7 tips ==

* To launch FPGA Editor, install following packages, then add symbolic links [https://askubuntu.com/a/1187070 as explained here].
<source lang="bash">
sudo apt install libxm4
</source>

== Troubleshooting ==

=== CoreGen TCL Evaluation Error ===

TCL problems with coregen come from an old version of java [https://wiki.archlinux.org/index.php/Xilinx_ISE_WebPACK#CORE_Generator_fails_to_generate_core as explain on archlinux wiki].

Solution #2 works :

<source lang="bash">
# backup old java
$ mv /opt/Xilinx/14.7/ISE_DS/ISE/java/lin64/jre/bin/java /opt/Xilinx/14.7/ISE_DS/ISE/java/lin64/jre/bin/java.old
# make symbolic link for java 6
$ ln -s /opt/Xilinx/14.7/ISE_DS/ISE/java6/lin64/jre/bin/java /opt/Xilinx/14.7/ISE_DS/ISE/java/lin64/jre/bin/java
</source>

==Links==
* http://www.xilinx.com/ise/logic_design_prod/webpack.htm
* Good french tutorial : http://harded.free.fr/site/?p=55
* [http://outputlogic.com/xcell_using_xilinx_tools/74_xperts_04.pdf to use it in command lines]
* [http://www.wiki.xilinx.com/ Xilinx Wiki]
* [http://forums.xilinx.com/ Xilinx forum]