Skip to content

Release history

Jump to bottom Edit New page
Juan Gonzalez-Gomez edited this page Jun 14, 2024 · 88 revisions

Introduction

Here you can find the release notes for the different versions of Apio

Index

Version Comments
Latest changes Latest commits in develop branch
Version 0.9.5 Bug fixed release: issues #379 and #380
Version 0.9.4 Bug fixed release: Bug fixed: unicode character map error in Windows OS and some linux distributions with non native unicode support
Version 0.9.3 Bug Fixes release: Bug fixed: apio graph, apio drivers, Documentation moved to wiki
Version 0.9.2 Bug Fixes release: Error when uploading, building, verifying from icestudio
Version 0.9.1 Top module name is now mandatory. [email protected]. New commands. Bug fixed. Cleaned Code
Version 0.8.4 Quick update release: New boards orangecrab, ButerSticr1.0
Version 0.8.3 Bug fixes release
Version 0.8.2 Obsolete apio packages removed. Github api no longer used. New boards. Many Bug fixed
Version 0.8.1 Transition to the oss-cad-suite complete!
Version 0.8.0.post1 Apio dependencies fixed
Version 0.8.0 Transitional version. Migration to oss-cad-suite in progress
Version 0.7.6 Bugs fixed. It works ok with icestudio >= 0.6.1
Version 0.7.5 Bug fixed. System package is obsolete
Version 0.7.4 Documentation moved to the wiki
Version 0.7.3 OpenFPGALoader added, oss-cad-suite package (0.0.3), refactoring
Version 0.6.7 Bug fixed
Version 0.6.3 New boards, Bug fixed, Github actions
Version 0.6.0 New boards: Orange Crab, Olimex, EDU-CIAA-FPGA...
Version 0.5.4 Bug fixed
Version 0.5.0 New board: Blackice-MX. Toolchain updated. Bug fixed
Version 0.4.1 Support new boards: Alchitry-Cu, Fomu
Version 0.4.0 New command: raw. Support new boards: UPDuino, iCEBreaker
Version 0.3.6 Improved TinyFPGA BX integration
Version 0.3.4 New boards: TinyFPGA BX, iCEblink40-HX1K. New command: lint
Version 0.3.3 New board: Alhambra II
Version 0.3.0 New commands. Updated apio drivers command
Version 0.2.0 New commands. New boards
Version 0.1.0 New commands: examples, init, system
Version 0.0.4 New commandos. Boards: IceZum Alhambra, iCEstick

Latest changes

Version 0.9.5

  • Date: 2024-June-14
  • NOTE: Bug Fix release
  • Bug fixed: issue #380, missing 'packaing' package in dependencies (Obijuan)
  • Bug fixed: issue #379, oss-cad-suite download link for darwin_x86_64 not correctly generated (Obijuan)

Version 0.9.4

  • Date: 2024-April-29
  • NOTE: Bug Fix release
  • Bug fixed: unicode character map error in Windows OS and some linux distributions with non native unicode support (Cavearr).
    • This bug caused Icestudio 0.12 not working ok in some platforms. Some unicode characters have been removed from apio (screenshots not updated in the documentation). They will be restored in next versions

Version 0.9.3

  • Date: 2024-April-02
  • NOTE: Quick update release
  • Bug fixed: apio main help: output reformated, by (Obijuan)
  • Documentation moved to the wiki, (Obijuan)
  • Windows: Apio drivers --ftdi_enable: code refactoring, (Obijuan)
  • Bug fixed: #363: Error when executing apio graph, (Obijuan)
  • issue #361: Improve error message in windows when running apio drivers --ftdi-enable, (Obijuan)

Version 0.9.2

  • Date: 2024-March-23
  • NOTE: Quick update release
  • Bug Fixed: Error when uploading, building, verifying from icestudio (Obijuan)

Version 0.9.1

Version 0.8.4

  • Date: 2023-Oct-3
  • NOTE: Quick update release
  • New board: orangecrab-r02-85f (benitoss)
  • New board: ButerSticr1.0 DFU & FT2232H (benitoss)
  • ECP5 FPGAs: compress bitstream generation (Add flag --compress) (benitoss)

Version 0.8.3

  • Date: 2023-Oct-1
  • NOTE: Bug fixes release
  • Fix duplicate execution for deprecated tools (Cavearr)
    • It solves two bugs in icestudio
      • Bitstream uploaded twice
      • No FPGA resources shown

Version 0.8.2

  • Date: 2023-September-29
  • NOTE: old apio packages fully removed
  • Adding documentation about apio build --top-module (luongb)
  • Apio build parameter for top-lvl module (luongb)
  • Apio build -v(verbose) fix (luongb)
  • Bug fixed: wrong type of quotes used. Caused JSON decoder error (luongb)
  • Add fpga for iCE40-UL1K-CM36A (Kirk Clendinning)
  • Adding the iCE UltraLite Breakout Board (Kirk Clendinning)
  • github actions improved (Obijuan)
  • Newer iCE40-HX8K and ECP5 Versa boards supported (Obijuan)
  • Python packages upgraded (request 2.28.2, click 8.1.3, colorama 0.4.6) (Obijuan)
  • Bug fixed in iCESugar-Pro (ahaberlach)
  • New board: Pico-Ice (benitoss)
  • Newer Icestick boards supported (himarcarmona)
  • New FT232H programer for the ColorLight i9 (jojo535275)
  • New USB-Blaster programer for the colorlight i9 (jojo535275)
  • Bug fixed in Colorlight 5A-75B V6.1 (benitoss)
  • Newer Lattice iCE40UP5K Breakout boards are supported (Kevin Lutzer)
  • New board: ColorLight-i9-v7.2_(FT2232H) (jojo535275)
  • Old functions removed (Obijuan)
  • Code refactoring (Obijuan)
  • Code clean: Lint score 10/10 (Obijuan)
  • Github API not accessed anymore. The latest version of the apio packages is shown in the VERSION file (Obijuan)
  • Obsolete packages no longer shown with apio install -l (Obijuan)
  • Obsolete Apio packages removed: Scons, dfu, icesprog, fujprog, Yosys, ecp5, iverilator, Verilator, System-tools (Obijuan)

Version 0.8.1

  • Date: 2022-April-28
  • NOTE: Transition to the oss-cad-suite complete! The old packages are obsolete, but can still be installed. In the next release they will be fully removed
  • Support for the iceWerx board added (Obijuan)
  • Examples added (Obijuan)
  • Test-examples: alhambra-II. Testbenches added (Obijuan)
  • ECP5: SConstruct: message: no time analysis (Obijuan)
  • ecp5: iverilog: scons: added missing " " (Obijuan)
  • ice40: Sconstruct. Iverilog: added missing " " (Obijuan)
  • Bug fixed: apio time only depends on the oss-cad-suite package (Obijuan)
  • Bug fixed: apio sim no longer requires the iverilog package] (Obijuan)
  • fixed: get_terminal_size() (Obijuan)
  • Added upduino v3.1 (vr2045)
  • The Alchitry Cu board fixes (goodney)
  • dfu, fujprog,icesprog and ecp5 packages declared as obsoletes (Obijuan)
  • Verilator declared as obsolete package (Obijuan)
  • Package iverilog is now declared obsolete (Obijuan)
  • Readme: Update OrangeCrab/ButterStick (gregdavill)
  • Test examples for different boards: (Obijuan)
    • Icesugar-1.5
    • Radiona ULX3S-12F
    • Icebreaker
    • TinyFPGA-BX
    • Fomu
    • ICE40UP
    • Blackice
    • ICE40-BreakBoard
    • Go-board
    • Alhambra II
    • Icezum Alhambra
  • Add butterstick support (and fix small orangecrab typo) (Andrew Goodney)

Version 0.8.0.post1

  • Date: 2022-April-2
  • Apio dependencies fixed
  • Bug fixed: It fixed the "get_terminal_size" error that appears because click version 0.8.1 was automaticaly installed (since March-28-2022)
  • The click version has been change to 0.7.2 temporaly for fixing the problem (it will be upgraded to 0.8.1 in the comming releases)

Version 0.8.0

  • Date: 2021-12-27
  • NOTE: Transitional version. All the old apio packages are being replaced by the oss-cad-suite. Many things can be broken, so use it with caution and fill issues with the problems found.
  • USE WITH ICESTUDIO >= 8.1 (It will NOT work with icestudio <=8.0)
  • Bumped to version 0.8.0 (Obijuan @Obijuan)
  • Synthesis of bitstream for ECP5 12K finally solved (Fernando mosquera (@benitoss))
  • Recover the support of iCESugar-nano (Fernando mosquera (@benitoss))
  • Synthesis for ECP5 12K solved (Fernando mosquera (@benitoss))
  • Making distinction between a v0 and v1 board (Thanks to seanybaggins @seanybaggins)
  • Solution for all ECP5 models (thanks to Fernando mosquera (@benitoss))
  • Support for the ECP5-Evaluation-Board (thanks to Fernando mosquera (@benitoss))
  • Fixed call to non-existant function (Thanks to seanybaggins @seanybaggins)
  • Update iCEBreaker-bitsy board support (Thanks to suzuki-naoto @suzuki-naoto)
  • apio lint now depends only on the oss-cad-suite package
  • test: apio verify passed
  • Bug fixed: apio verify error in ice40
  • iverilog is run from the oss-cad-suite package
  • scons upgraded to the latest version: 4.2.0
  • scons is no longer an independent apio package. It is installed as a python package instead
  • scons apio package is now obsolete and not installed with apio install -a
  • Bug fixed: trellis and icebox environment variables fixed
  • ECP5: Bug fixed: Bitstream regenerated when the .lpf is changed
  • Support for the FleaFPGA-Ohm Board added (thanks to Fernando mosquera (@benitoss))
  • lib folder included in the path
  • ice40 package: no longer needed for building
  • Package ice40 marked as obsolete
  • yosys: included in the obsolete package list
  • build: package oss-cad-suite used instead of yosys

Version 0.7.6

  • Date: 2021-07-26
  • Bug Fixed: The checking of the installed packages was not correctly done if they are installed in another folder different than the default
  • Now it should work ok with Icestudio >=0.6.1

Version 0.7.5

  • Date: 2021-07-21
  • Tools-system package is no longer installed with apio install -a (as it is considered obsolete)
  • Security vulnerability fixed. Thanks to @Xesxen. No token used for accesing the github api: Currently only 60 petitions per hour can be made, but it should be enough by the moment (as it is only used for installing packages)
  • Fixed a bug in the tests. Thanks to @Luflosi

Version 0.7.4

  • Date: 2021-07-20
  • All the images used in the documentation wiki have been moved to the repo Apio-wiki and no longer are included in the pypi apio package (so it is faster to download and to install)

Version 0.7.3

  • Date: 2021-07-20
  • Toolchain ECP5:
    • OpenFPGALoader tool added for programing the ECP5 FPGAs (Thanks to Fernando Mosquera (@benitoss))
  • New apio package: oss-cad-suite
    • Currently only with the system tools: lsusb, lsftdi, ftdi_eeprom
  • Apio system package marked as obsolete (although it can still be installed and used). Use the oss-cad-suite apio package instead
  • Refactoring and documentation of the code

Version 0.6.7

  • Date: 2021-06-26
  • Bug fixed: Extra packages are separated, so that they can be installed individually
    • blackiceprog
    • litterbox
    • tinyfpgab
    • tinyprog
    • icefunprog
  • More bug fixed

Version 0.6.3

  • Date: 2021-06-26
  • Add OK-iCE40Pro to boards.json
  • Support iCESugar-nano board
  • Initial support for the Colorlight boards
  • Bug fixed
  • Migration to flit
  • Migration to Github actions
  • Automatic publishing of version in pypi for every release
  • Bug Fixed: Environment variables with quoted paths are allowed

Version 0.6.0

  • Date: 2020-12-13
  • New board: OrangeCrab
  • New board: olimex board
  • New board: IceFun
  • New board: Upduino v3.0
  • New board: EDU-CIAA-FPGA
  • Many Bugs fixed
  • New package: fujprog
  • New board: Radiona ULX3S
  • New board: iCESugar v1.5
  • Documentation added
  • New package: dfu

Version 0.5.4

  • Date: 2020-02-26
  • Fix ecp5 and ice40 definitions
  • Bug Fixed

Version 0.5.0

  • Date: 2020-02-21
  • New board: Blackice-MX
  • Bug Fixed
  • Toolchains updated

Version 0.4.1

  • Date: 2019-09-09

Added

  • Support new boards:
    • Alchitry-Cu (#179)
    • Fomu (#182)
  • Add project structure to the docs (#177)

Fixed

  • Pytest "offline" option
  • Production iCEBreaker USB strings (#181)

Version 0.4.0

  • Date: 2018-11-07

Added

  • New command: raw.
  • Support new boards:
    • UPDuino v1.0
    • UPDuino v2.0
    • iCEBreaker
    • iCEBreaker bitsy
    • FPGA 101 Workshop Badge Board
    • iCE40 UltraPlus Breakout Board

Version 0.3.6

  • Date: 2018-09-16

Changed

  • Improve TinyFPGA BX integration

Version 0.3.4

  • Date: 2018-08-17

Added

  • New command: lint.
  • Support new boards:
    • TinyFPGA BX
    • iCEblink40-HX1K

Version 0.3.3

  • Date: 2018-05-10

Added

  • Support new boards:
    • Alhambra II

Version: 0.3.0

  • Date: 2018-02-01

Added

  • Support new boards:
    • TinyFPGA B2
    • BlackIce
    • BlackIce II

Changed

  • Update "apio drivers" options: ftdi, serial.

Version 0.2.0

  • Date: 2016-12-01

Added

  • New commands: verify, boards, config, drivers, upgrade.
  • Support new boards:
    • Nandland Go board
    • icoBOARD 1.0
    • Kéfir I iCE40-HX4K
    • iCE40-HX8K Breakout Board
    • CAT Board

Removed

  • Delete command: debug.

Version 0.1.0

  • Date: 2016-04-14

Added

  • New commands: examples, init, system.

Version 0.0.4

  • Date: 2016-02-24

Added

  • New commands: build, clean, debug, install, sim, time, uninstall, upload.
  • Support new boards:
    • iCEstick Evaluation Kit
    • IceZUM Alhambra.

Add a custom footer

Apio Home page

ICESTUDIO

Getting started

Apio projects

Boards

Apio commands

Apio examples

Apio packages

Development

Help

Legacy

Clone this wiki locally