Skip to content

Conversation

pschatzmann
Copy link
Owner

@pschatzmann pschatzmann commented Sep 23, 2025

Breaking Changes

The 1.2.0 release contains some breaking changes.

  • I was making the http an optional functionality!. This has the advantage that WiFi.h is not included by default, so the resources are reduced dramatically for sketches that do not need any networking:

An empty sketch only importing AudioTools.h was using

Sketch uses 888547 bytes (67%) of program storage space. Maximum is 1310720 bytes.
Global variables use 43352 bytes (13%) of dynamic memory, leaving 284328 bytes for local variables. Maximum is 327680 bytes.

With 1.2.0 it is quite smaller

Sketch uses 281671 bytes (21%) of program storage space. Maximum is 1310720 bytes.
Global variables use 20768 bytes (6%) of dynamic memory, leaving 306912 bytes for local variables. Maximum is 327680 bytes.

Compared with an empty sketch, including this library just uses 20 bytes progmem and 8 bytes of dynamic memory!

If you want to use some networking functionality use

#include "AudioTools.h"
#include "AudioTools/Networking/AudioHttp.h"
  • The second breaking change is that all communication related functionality has been moved from AudioLibs to Communication
    • A2DPStream
    • AudioClientRTSP.h
    • AudioServerEx.h
    • HLSStream.h
    • VBANStream.h

So please use the new location e.g.

#include "AudioTools.h"
#include "AudioTools/Communication/A2DPStream.h"

New Functionality

  • new converter class ChannelMixer to convert 1 stereo into 2 identical mono channels
  • the RTSP Server and Client has been integrated into this library

Improvements:

  • FLACDecoderFoxen/OpusAudioDecoder: optoinal support for release on end
  • Platform tests: add giga,zephyr, stm32
  • Doxygen comments on div classes
  • AudioSource, Metadata: change begin from void to bool
  • CodecWAV: convert 8 bits to 16 bits
  • ESP32 configuration: USE_LEGACY_I2S to select I2S implementation
  • GoertzerlStream: support for multiple frequencies
  • AudioInfo: bool() check for range
  • EncodedAudioStream/EncodedAudioOutput get AudioInfo from decoder

Errors Corrections

  • GIGA R1: Compile errors
  • AudiopPlayer: copy(size_t) on silence: correct written silence size
  • CopyEncoder: prevent NPE
  • EncodedAudioStream/EncodedAudioOutput: prevent invalid AudioInfo

@pschatzmann pschatzmann changed the title move HTTP to Communication move HTTP to v1.2.0 Sep 23, 2025
@pschatzmann pschatzmann merged commit 4a38e98 into v1.2.0 Sep 23, 2025
@pschatzmann pschatzmann deleted the HTTP branch September 23, 2025 06:44
@pschatzmann
Copy link
Owner Author

Breaking Changes

  • Communication related functionality moved from AudioLibs to Communication

    • A2DPStream
    • AudioClientRTSP.h
    • AudioServerEx.h
    • HLSStream.h
    • VBANStream.h
  • WiFi & Http are optional functionality now: use include "AudioTools/Communication/AudioHttp.h" or the indivicual classes

New Functionality

  • new converter class ChannelMixer: (e.g. 1 stereo to 2 mono)
  • RTSPServer and Client has been integrated into this library

Improvements:

  • FLACDecoderFoxen: optoinal support for release on end
  • Platform tests: add giga,zephyr, stm32
  • Doxygen comments on div classes
  • AudioSource, Metadata: change begin from void to bool
  • CodecWAV: convert 8 bits to 16 bits
  • ESP32 configuration: USE_LEGACY_I2S to select I2S implementation
  • GoertzerlStream: support for multiple frequencies
  • AudioInfo: bool() check for range
  • EncodedAudioStream/EncodedAudioOutput get AudioInfo from decoder

Errors Corrections

  • GIGA R1: Compile errors
  • AudiopPlayer: copy(size_t) on silence: correct written silence size
  • CopyEncoder: prevent NPE
  • EncodedAudioStream/EncodedAudioOutput: prevent invalid AudioInfo

@pschatzmann pschatzmann changed the title move HTTP to v1.2.0 move HTTP to prepare-1.2.0 Sep 23, 2025
pschatzmann added a commit that referenced this pull request Sep 23, 2025
* Move  to Communication from AudioLibs

* bump to 1.2.0

* move HTTP to v1.2.0 (#2176)

* move HTTP to Communication

* RTSP corrections

* Move  to Communication from AudioLibs

* bump to 1.2.0

* move Player Remote Control to Communication

* AudioPlayerContro.h

* A2DPStream to Communication

* Delete AudioLibs/All.h

* USE_RTSP_LOGIN

* USE_RTSP_LOGIN

* RTSPClient: error corrections

* RTSP corrections

* examples: correct build errors
pschatzmann added a commit that referenced this pull request Sep 23, 2025
* Move  to Communication from AudioLibs

* bump to 1.2.0

* move HTTP to v1.2.0 (#2176)

* move HTTP to Communication

* RTSP corrections

* Move  to Communication from AudioLibs

* bump to 1.2.0

* move Player Remote Control to Communication

* AudioPlayerContro.h

* A2DPStream to Communication

* Delete AudioLibs/All.h

* USE_RTSP_LOGIN

* USE_RTSP_LOGIN

* RTSPClient: error corrections

* RTSP corrections

* examples: correct build errors

* AudioPlayer: improve comments

* Documentation: public methods

* Documentation
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant