GitLab

(which contains sensitive customer data).

Version 1.46. Tagged as 'HdrSrc-1_46'

* Changed Hdr:Debug not to rely on Hdr:Proc (to prevent some macro clashes).
* Added Hdr:Machine.STB5

Version 1.43. Tagged as 'HdrSrc-1_43'

Detail:
  * Extra GraphicsV definitions
  * Service_Device renamed Service_Hardware
  * GRAB macro fixed for objasm compatibility
  * Enabled HiResTTX for Tungsten, and added 256-colour TTX option
Admin:
  Used in builds including release 5.00 (except the TTX bits).

Version 1.37. Tagged as 'HdrSrc-1_37'

Addition of Tungsten machine and Iyonix user interface.
New 1024k ROM image size.

Version 1.35. Tagged as 'HdrSrc-1_35'

  Changed some base 4 constants to binary (for Hdr2H)
Detail:
  Lots of additions to allocations since it's been a long time since
    the last resync with Pineapple.
Admin:
  E-mail received 2002/04/02 (includes hdr/RISCOS change in Kernel)


Version 1.34. Tagged as 'HdrSrc-1_34'

Detail:
    A new file, 7168K, has been added to hdr.ImageSize.
Admin:
    Untested. Woohoo

Version 1.26. Tagged as 'HdrSrc-1_26'

Detail:
  * Added register definitions for the new registers in those wacky new ARM2
    chips, r8_fiq and r9_fiq.
  * Added abort and undefined mode register definitions using the ARM ARM
    standardised suffix of _abt and _und (previously we only had _abort and
    _undef versions).
  * Added some sanity checking of the fields parameter to the RestPSR macro,
    to help warn the unwary of the effect of compiling No32bitCode.
Admin:
  Changes appear to function as desired. Debug builds of MPEGDriver actually
  require those extra register definitions.

Version 1.23. Tagged as 'HdrSrc-1_23'

* New header file "Hdr:UserIF.UserIF" provided for definitions specific to the user interface on products.  This abstracts the UI definitions from the machine-specific ones, and (ultimately) allows more flexibility in the choice of Machine and UserIF build combinations.

Detail:

  * As part of the work to remove the (almost obsolete) STB flag, a new
    flag has been defined: Embedded_UI.  This is provided by the "UserIF"
    header file.  The file should not be directly included; instead use the
    same mechanism as for "Hdr:Machine.Machine" and use "Hdr:UserIF.<UserIF>".

    In the past, the STB flag has been used to mean different things in
    different software components, some machine-dependent but more often than
    not to differentiate desktop builds from STB/NC versions.  Two types
    of system are identified: "Desktop" and "Embedded"; UserIF_Type is
    defined as a string containing the UI type.  STB/NC user interface
    differences should be encapsulated in appropriate "Embedded_UI" switches.
    Any other user interface-specific changes should probably define a new
    flag in the UserIF header file.

    Presently, the STB flag remains intact in "Hdr:Machine.Machine" to allow
    builds to progress as normal until all software components that utilise
    it have been appropriately modified to remove the dependency.  For
    example, the Kernel makes heavy use of the flag, but after HAL-isation
    will no longer do so.  Once all software components have been modified
    the flag will be withdrawn, and feature tests or appropriately defined
    user interface flags will be used instead.

  * "Hdr:CMOS" revised to remove definitions under the control of the defunct
    ObsoleteNC1CMOS flag.  Furthermore, the STB flag conditional has been
    removed.

Admin:

  * Tested using appropriately modified software components on a 32-bit
    Lazarus build.

  * Use of the STB flag is now deprecated.  Software components should
    use "Hdr:UserIF.<UserIF>" or specific feature tests from this point
    onwards.  Appropriate header files exist inside the "Hdr.UserIF"
    directory for each user interface type.

Version 1.17. Tagged as 'HdrSrc-1_17'

Version 1.16. Tagged as 'HdrSrc-1_16'

Detail:
  OSLib defines "True" and "False" as integer variables, but Hdr:Symbols
  defines them as logical ones. Hdr:Proc assigned "True" and "False" to
  logical variables, so there was no way that it could be used with any
  component that used any OSLib or even DefMod-generated headers. Hdr:Proc
  now uses the unambiguous "{TRUE}" and "{FALSE}" symbols.
Admin:
  Required by SoundFileExtMSADPCM 0.06.

Version 1.15. Tagged as 'HdrSrc-1_15'

Extra errors added for OS_Hardware.
Hdr:Machine.Machine flag changes for "M_32" build.

Version 1.09. Tagged as 'HdrSrc-1_09'

Detail:
  * Hdr:Macros: ASCII_LowerCase and ASCII_UpperCase are the same as
    uk_LowerCase and uk_UpperCase, but don't produce the warnings, on the
    basis that the user acknowledges that they are only to be applied to
    ASCII characters.
  * Re-used CMOS byte 188 bit 0 to configure whether the Wimp responds to
    clicks on menu items with attached submenus by opening the submenu. This
    bit was previously one of two allocated to the ROMFS *Opt4 state; the
    other bit is now spare.
  * Clarified a few comments in Hdr:CMOS relating to the use of bits under
    the Ursula Wimp.
Admin:
  Required by Wimp 4.57.

Version 1.06. Tagged as 'HdrSrc-1_06'

Detail:
  $regtop instead of $regtmp meant that 32-bit builds would fail to
    assemble correctly.
Admin:
  Required by PDModules 4.45 and later

Version 1.05. Tagged as 'HdrSrc-1_05'

Detail:
  * Debug macros can now be used to output the value of r13 (previously, the
    value of r14 was erroneously output instead).
  * Switched from using mrs macros to mymrs macros, so builds with the
    No32BitCode flag unset are now objasm-compatible.
Admin:
  Has been used in a debugging session, and debug routines worked as expected.

Version 1.04. Tagged as 'HdrSrc-1_04'

* Added new flags and bits to Hdr:MEMM.ARM600.
* Added "HAL" switch in Hdr:Machine.Machine. True only for my prototype M_32.

Version 1.03. Tagged as 'HdrSrc-1_03'

Macro for assembly of new BKPT instruction added (useful for the emulator).

Version 0.91. Tagged as 'HdrSrc-0_91'

Modified "Push" and "Pull" macros to use STR/LDR for single-register operations. This will fail (loudly) if a named register list is used. I've never seen anyone use one though.

Tested on a cut-down ROM build. There shouldn't be any room for failure,
unless someone is using the macro to generate data (eg for a detected code
sequence in a patcher).

Version 0.90. Tagged as 'HdrSrc-0_90'

Detail:
  TOGPSRR does the same as TOGPSR except that the bits to toggle
    are held in a register.
  Hdr:Sprite contains declarations that are mistranslated by Hdr2H 1.1.
    Hdr2H has been updated to handle these declarations and is first
    present in RiscOS/Library 0.45.
Admin:
  Required by DualSerial 0.24 and later.
  Requires Library 0.45 to export a correct C version of Hdr:Sprite

Version 0.88. Tagged as 'HdrSrc-0_88'

Hdr:NdrDebug made fully 32-bit compatible (only change is to the code switched
    using the debug_nullterminatedstrings variable).

Version 0.86. Tagged as 'HdrSrc-0_86'

Version 0.85. Tagged as 'HdrSrc-0_85'

* Added $oldpsr extension to SETPSR, CLRPSR and TOGPSR.
* Removed reliance on ObjAsm default macro parameters in $oldpsr extension.
* Replaced SavePSR macro calls with literal mrs instructions in 32-bit macros.

Version 0.84. Tagged as 'HdrSrc-0_84'

Detail:
  Improved some of the PSR wiggling macros with an optional extra
    register into which to save the old PSR.  Saves an extra MRS
    instruction in some cases.
  Some macros changed to invoke SavePSR macro instead of having a copy
    of the macro body.
Admin:
  Required by ScrBlank 2.30.

Version 0.83. Tagged as 'HdrSrc-0_83'

LDR/STR instead of single-register LDM/STM.

Version 0.82. Tagged as 'HdrSrc-0_82'

More 32-bit tweaks. Some assembler macros extended to accept condition codes and PSR flag subset specifiers.

CPU.FPA header file added.

Version 0.79. Tagged as 'HdrSrc-0_79'

Lazarus.
Minor optimisation to RemovePSRFromReg macro.

Version 0.71. Tagged as 'HdrSrc-0_71'

Detail:
  This stops the errors occurring in 26-bit builds when the EntryS
    macro is invoked without quotes around the register list.
Admin:
  Fixes problems with the latest ARM module not building.


Version 0.66. Tagged as 'HdrSrc-0_66'

Detail:
  The 32-bit version of WritePSRc takes an optional third parameter
    which is the condition code to embed in the instruction.
    The 26-bit mode version now takes the same parameters, thus
    allowing Sound2 (SoundScheduler) to build.
Admin:
  Tested in Phoebe and 32 machine builds of Sound2.
  Required by SoundScheduler 1.25 and later (Sound2-1_25)

Version 0.65. Tagged as 'HdrSrc-0_65'

Detail:
  Pointless jumping over the generated code or inserting conditional
    instructions which will never be executed.

Detail:
  The 26-bit and 32-bit capable macros have been added.
  Header files choose which set of macros to use based on <Machine>.
  If you want the new macros, include "Hdr:APCS.<APCS>" in addition
    to the usual inclusions at the top of assembler files.
  Choices are based on the settings of macros No32bitCode and
    No26bitCode.  By default, all existing machines define these
    as {TRUE} and {FALSE} respectively.  This yields the same macros
    as before (tested in Customer F 5 build) and should yield code which
    functions on RISC OS 3.1.  Any other combination of settings is
    untested at this time.
  New assembler code should use the macros FunctionEntry, Return et al
    to ensure that they build correctly.
  New assembler code should be written to not require flag preservation
    across internal function calls and to not assume it on external
    function calls where it is possible to do so.  DO NOT simply replace
    "MOVS pc, lr" with "MOV pc, lr" as this doesn't work properly.
    Replace "MOVS pc, lr" with "Return ,LinkNotStacked"
  Do not write code which simply masks out &FC000003 from pc or some kind
    or pc originated value (eg. on r14 to attempt to remove the PSR flags
    from it.  Use the RemovePSRFromReg macro instead.
Admin:
  Tested with Customer F 5 build.
  Requires FPEmulator 4.11
  Requires Portable 0.65 (or Portable75 0.04)
  Required by any new or modified assembler code in future, pretty much.
    Such components may not necessarily specify a dependency on this
    or any other later version of HdrSrc.

Version 0.63. Tagged as 'HdrSrc-0_63'

Removed conditional compilation from reassigned IOMD interrupt stuff. Both sets of allocations are now included, prefixed by IOMD_ and IOMDr_.

This complicates the Kernel, where it is fixed at compile time, but it should
simplify everthing else, which will handle both at run time.

Version 0.52. Tagged as 'HdrSrc-0_52'

New version of DevNos will need to be sent to Pineapple, I expect.
IRQ changes will probably have repercussions throughout the build.

Version 0.51. Tagged as 'HdrSrc-0_51'

Detail:
  Various source modules contain his header privately, and all have
    slightly differently commented versions, with or without
    assertions.  This was was voted best-in-class and promoted into
    the Macros file.
Admin:
  Tested briefly.


Version 0.45. Tagged as 'HdrSrc-0_45'

Version 0.29. Tagged as 'HdrSrc-0_29'

Version 0.25. Tagged as 'HdrSrc-0_25'

Added debug_irqsafe option, which converts a 32-bit number to a	string itself, without calling OS_ConvertHex8.

Retagged as HdrSrc-0_20.

* folded in Ursula branch (support for PDebug module);
* added support for control characters within strings (eg control sequences in
  strings to be passed to Font_Paint);
* added support for DADebug module;
* made debug method-independent code easier to write by making the Debug_Open
  and Debug_Close macros do nothing when module output is selected, and by
  predefining the hostvdu variable as false if it's not yet defined.

Version 0.20. Tagged as 'HdrSrc-0_20'

Version 0.13. Tagged as 'HdrSrc-0_13'

Updated imported headers from htohtaza.  Added STB3 machine file, and extra options associated with that machine.

Version 0.08. Tagged as 'HdrSrc-0_08'