--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/kernel/eka/release_old.txt Mon Oct 19 15:55:17 2009 +0100
@@ -0,0 +1,17108 @@
+
+Version 1.02.371
+================
+(Made by Dennis 04/04/2002)
+
+1) TimBa
+ 1) Fix for BAD-58CDM4: Locale change has no effect on contact filtering.
+2) ChrisM
+ 1) Fix for MOS-58EJ8V (Integrator calibration doesn't work properly)
+ Removed the "patches" from the Y coordinate digitizertoscreen calculation and
+ changed the Y calibration constants to work with this.
+ 2) Fix for CAR-57RETM (WINSCW UDEB Emulator crashes when launched in console mode)
+ 3) Fix for TAR-58LEUV (Emulator title - variant indication) CR ref MTAR-58LDG2
+ 4) Fix for SHY-58GGR5 (Test case that leads to unhandled exception
+ in DThread::GetDesMaxLength)
+
+3) Nicolas
+ 1) Fixed defect THY-588MLT (Integrator board with ARM926
+ core module does not boot). The ARM920 clock setting
+ code can not be reused as-is for ARM926. Modified
+ bootstrap to figure out which core is being used and
+ branch to the appropriate code. A software reset is
+ necessary halfway through the ARM926 clock
+ configuration. See comments in HwInitialise for more
+ details. For ARM926, the clocks are set to:
+ CPU: 125mhz
+ system bus: 25mhz
+ local bus: 31.25mhz (CPU clock / 4)
+4) AndrewJ
+ 1) Fixed defect JON-58DHHP where Assabet lffs media driver has an error in
+ suspend resume operation.
+5) MarkCa
+ 1) Fixed CAN-58GG5E (MEDMMC is not leave-safe.) Used non-leaving new in
+ D_MEDMMC.CPP.
+
+6) PeteS
+ 1) Added Lubbock Base port.
+
+Version 1.02.370
+================
+(Made by CarlosF, 12/03/2002)
+
+1) JonathanM
+ 1) Fix for defect MET-57ZHTH - "TDblQueBase has incorrect copy constructor
+ and operator ="
+
+2) Nicolas
+ 1) Fixed defect MET-57YN7A (Power Sequence at EmergencyStandby).
+ Migrated 6.1 fix: In DPowerModel::PowerEmergencyStandbyDfc(),
+ PowerEmergencyStandby() is now called for all power handlers
+ *before* switching off the machine.
+ 2) Fixed defect MET-57YMU7 (Template Port requires 'EARLY
+ DEBUG' examples in the template code).
+ 3) Modified template port to use the same UART API as
+ recent ports, e.g. Uart1Data() and Uart2Data()
+ replaced with UartData(TUint32 aUartBase).
+ 4) Fixed defect THY-585N22 (OOM during process creation
+ can crash the kernel). Now uses HBufC::New() instead
+ of NewL() in svProcessCreate() to allocate the
+ command-line buffer.
+
+3) Markdo
+ 1) Fixed defect DON-585LNV "Media door open does not work on WINS with
+ Mmc card controller". Removed call from PcCard Controller to set up a
+ media change callback in WINS. Only MmcCard Controller sets this callback
+ now.
+
+4) ChrisM
+ 1) Fixed defect MOS-586BWV (integrator had digitizer and mouse driver loaded
+ in e32 text shell roms). Removed mouse driver from rom.
+ 2) Fixed defect MOS-55DJN4 (New integrator video driver should use constants
+ rather than magic numbers)
+ 3) Tidied up integrator digitizer calibration.
+ 4) Fixed defect OMC-586LJF assabet rom size
+ 5) Fixed defect OMC-586K5Z mainline warnings
+
+5) Pete
+ 1) Change to the WINS local drive mappings.
+ The entire local drive mapping for WINS is now as follows:-
+ Local drive 0: Internal RAM drive (EFixedMedia0) - Y:
+ Local drive 1: MMC Card on MMC socket 0 (ERemovableMedia0) - X:
+ Local drive 2: MMC Card on MMC socket 1 - Partition1 (ERemovableMedia1)
+ Local drive 3: MMC Card on MMC socket 1 - Partition2 (ERemovableMedia1)
+ Local drive 4: PC Card on PC Card socket 0 (ERemovableMedia2)
+ Local drive 5: PC Card on PC Card socket 1 (ERemovableMedia3)
+ Local drive 6: Not currently assigned
+ Local drive 7: Not currently assigned
+ Local drive 8: Internal LFFS drive (EFixedMedia1) - W:
+ 2) Implemented CR PHAR-54RJMT 'We should be able to simulate password
+ protected disks on the emulator'.
+ 1) The method of mapping drive letter to local drive number on the WINS
+ emulator has been changed from being a fixed mapping, to one that uses
+ enviroment variables to specify the mapping. When the system starts up
+ it sets environment variables to reconstuct the same mapping as before:
+ Y:-LocDrv 0, X:-LocDrv 1, W:-LocDrv8. (This is done in SetupEmulatorPaths()
+ in \e32\euser\emul\win32\up_path.cpp). However, these default mappings can
+ overidden or new mappings created in EPOC.INI using the following syntax:
+
+ _EPOC_LocDrv_<locDrvNum> <drvLetter>: <FileSystemID string>
+
+ The FileSystem ID indicates which file system should be mounted on the
+ local drive in question. The following file system IDs are defined:
+ 'Fat' and 'Lffs'.
+ For example, to map X: to local drive 1 specifying the FAT file system:
+ '_EPOC_LocDrv_1 X: Fat'
+ The file system ID is read by the text shell as it starts up and mounts the
+ appropriate file system on any local drive that it finds a mapping for.
+ 2) A start-up media password can now be assigned to any MMC card - again
+ using environment variables to store the password. Passwords are set in
+ EPOC.INI using the syntax:
+
+ EPOC_LocDrv_<locDrvNum>_PWord_<cardNum> <password>
+
+ 'locDrvNum' is the number of the local drive and 'cardNum' is the number of
+ the MMC card on that drive. The latter is only relevant on local drive 1 where
+ two virtual MMC cards are emulated (with the user hot swapping between cards
+ by hitting F4 while F5 is down). For example, to set Card0 on local drive 1:
+ 'EPOC_LocDrv_1_PWord_0 aaa1'
+
+ 3) The start-up state of the MMC card in local drive 1 can be configured to be
+ any one of the following: No MMC card, MMC Card0 or MMC Card1. The user
+ subsequently toggles between each of these states each time they hit the F4 key
+ while F5 is down. The start-up state is set in EPOC.INI using the syntax:
+
+ _EPOC_Active_LocDrv_1 <StartUpState>
+
+ 'StartUpState' can be one of the following values: -1 - card present,
+ 0 - MMC Card0, 1 - MMC Card1. For example, to set the start up state to MMC Card1:
+ 'EPOC_Active_LocDrv_1 1'
+
+6) MarkCa
+ 1) Removed SD specific parts of MMC controller. EPBUSM no longer built for MEIG.
+
+7) TimBa
+ 1) Fix for COY-56DEYY: "MatchesPartial function uses undocumented
+ feature of CompareC". TDesC16::HasPrefix function added.
+
+
+Version 1.02.369
+================
+(Made by ChrisM, 06/03/2002)
+
+0) ArunsakhS
+ 1) Fix for defect BAD-57HF3Y - "Locale persistence broken"
+ A new HAL atrribute was added to TAttribute in Hal_data.h for the
+ defect fix above. The new attribute is "ELocaleLoaded".
+ Made the required changes to "config.hcf" and "values.hda" in HAL
+ and all the reference platform components. Added the test for
+ ELocaleLoaded in the test "T_newhal" in HAL.
+
+1) RobertJ
+ 1) Silenced some warnings in:
+ \e32\drivers\medmmc\epoc\d_medmmc.cpp
+ \e32\drivers\medmmc\epoc\d_medsdp.cpp
+ 2) Correction of comms header file to correct KCapsBpsxxxx constants
+ \e32\include\d32comm.h
+ JAN-57WL3N "Comm port capability constants same, missing"
+ (was SAS-554K4P in GT6.1)
+ 3) Fixed JAN-57WL8G "Possible access violations in e32 drivers under OOM?"
+ was HAR-56DPLW in GT6.1
+ \e32\drivers\dfir\d_fir.cpp
+ \e32\drivers\ecomm\d_comm.cpp
+ \e32\drivers\ecommdce\epoc\d_commdce.cpp
+
+2) CarlosF
+ 1) Fixed defect MOS-579LUN powering down digitiser causes machine to hang
+ when screen is tapped.
+ 2) Changes to Serial Port: the existing power-down timeout after finishing
+ transmitting has been made configurable through the introduction of a new
+ member to the comms config structure (this is now TCommConfigV02).
+ Changes to d_comm.cpp (ARM and WIN32 emulator) to support this. Also when
+ it powers down as a consequence of having timed out it now completes the
+ requests with KErrTimedOut instead of KErrAbort.
+ 3) Further changes to the digitiser extension on Assabet and Brutus in order to
+ fix problems with Silent Running.
+ 4) Fixed defect THE-57LHGD Unable to use the Profiler tool on Assabet.
+
+3) MichaelP
+ 1) Added data member access function TInt BytesToBeTransfered() to class
+ THwaDataTfReq (k32hwa.[h|inl]).
+ 2) In T_HWA (\f32test\DEVICE\t_hwa.cpp) changed test of "HWA device specific
+ function (2)": the address that is now used lies within the DSP bridge
+ shared memory area.
+ 3) Fixed address and size of reserved RAM area in \Helen\Bootstrap\Helen.s.
+
+4) MarkCa
+ 1) Fixed CAN-579MLN MultiMediaCard controller does not pre-check current
+ password.
+
+5) Nicolas
+ 1) Fixed defect THY-57QNYA (incorrect default debug port
+ on assabet). The default port is now UART3
+ everywhere.
+
+7) ChrisM
+ 1) Fix for DON-57RNLR (Screen is not switched on when coming back from digitiser
+ power-down)
+ 2) Fix for defect PEN-57XBRV ("EPOC Emulator" should be replaced)
+ Changed the emulator name from EPOC Emulator to Symbian OS Emulator by default.
+ Name can be specified in epoc.ini with the keyword EmulatorName.
+
+
+Version 1.02.368
+================
+(Made by RobertJ, 11/02/2002)
+
+1) ChrisM
+ 1) Fix for defect ROS-55CGCR - "EPOC.EXE logo fails to conform to Corporate ID guidelines"
+
+3) JonathanM
+ 1) Fix for defect MET-572N7U - "Destroying FixedContiguous TransferBuffers causes
+ memory to be 'lost' to the free pool"
+
+4) Pete
+ 1) Further extended the local drive caps class (TLocalDriveCapsV3)
+ by adding the following member:-
+ TUint iExtraInfo;
+ 2) Modified the MMC Media driver to supply the above information as part of
+ the Media Driver Caps() function.
+ 3) Fixed a defect where the 'iHiddenSectors' field in
+ the disk caps. info was not being initialised if a default boot
+ partition wasn't detected in the MBR.
+
+Version 1.02.367
+================
+(Made by PeterS, 02/02/2002)
+
+1) RobertJ
+ 1) CR CLCT-55JENG. Modified \e32\include\d32usbc.h & \e32\include\d32usbc.inl
+ argument TInt& aLen for RDevUsbcClient::Write and
+ RDevUsbcClient::WriteEndpointZero changed to TInt aLen
+
+2) JonathanM
+ 1) Fix for defect FID-563G8A - "TPckgBuf cannot return a const reference"
+ 2) Fix for defect PAR-56MGEB - "Generic EDISP driver lives in the wrong place."
+ 3) Removed last vestiges of Cogent from E32
+ 4) Fix for defect THY-4XPH4C - "T_CURRENCYFORMAT fails from time to time"
+ 5) Fix for defect MET-56UJ35 - "Unhandled Leave in Kernel Server"
+ 6) Fix for defect MET-56VJY6 - "Session creation can crash machine under OOM conditions"
+
+3) MarkCa
+ 1) Added caps buffer zeroing to MEDMMC and MEDLFS on MINT and MINK.
+
+4) Nicolas
+ 1) CR JPAR-54XMZD: ROM building and run time configuration of debug port
+ - On selected targets the current debug port can be
+ viewed and changed at run-time thanks to a new eshell
+ command (debugport). See rombuild release notes for details
+ about ROM building time configuration.
+ - Debug port setting applies everywhere (i.e. bootstrap
+ traces, early debug mode, non early debug mode (variant)
+ and debug monitor) *but* run-time port switching is not
+ supported in early debug mode as in this case the port
+ initialisation is done by the bootstrap.
+ - The bootstrap fetches the debug port from the ROM
+ header and copy it to a new field in the the super page.
+ - A new HAL attribute (EDebugPort) has been added and
+ a default implementation based on userhal has been provided.
+ - Assabet port modified. The accepted debug port
+ values are 1 (UART1) and 3 (UART3). The default is 3.
+ - Brutus port always uses UART3.
+ - Integrator (MINT) port modified. The accepted debug
+ port values are 0 (UART0), 1 (UART1) and 42 (JTAG DCC). The
+ default is 0.
+ - KHARDWAREASSIST flag removed. Ports supporting JTAG
+ DCC output should use the new scheme.
+ - Modified accordingly the template port
+ 2) Modified bootvariant.mke in MINT port so that a symbol
+ file for bootromv1.bin is generated.
+ 3) Fixed long standing bug in MISA variants: BOOTMISA.LIB was
+ not suffixed by a variant-specific identifier. This was
+ not discovered before as the libraries were identical on
+ assabet and brutus. The libraries are now called
+ BOOTMISAAB.LIB and BOOTMISABA.LIB.
+ 4) "abld clean bootmisa" now removes symbol files for both
+ assabet and brutus.
+
+5) ChrisM
+ 1) Euser source reorg for ipr categorisation CR GBON-567RCZ
+ - created new directory base\e32\euser\utils
+ - moved us_array.cpp, us_func.cpp, us_lex8.cpp, us_lex16.cpp, us_heap.cpp
+ and us_que.cpp into the new dir which has a cat D ipr file.
+ - created new file us_desx.cpp which contains all the exported constructors
+ from us_des8.cpp and us_des16.cpp
+ - created a new header file in utils which contains some inline funcs which
+ are needed in us_desx.cpp and the old us_des8.cpp and us_des16.cpp files
+ - + some panic numbers and a few other shared bits.
+ - removed the exported constructors from us_des8.cpp and us_des16.cpp
+
+
+
+
+Version 1.02.366
+================
+(Made by MarkCa, 15/01/2002)
+
+1) MarkCa
+ 1) Modified MEDMMC to support partial reads, write-through caching and
+ multi-block writes. Multi-block writes are a compile-time option
+ that is not compiled in by default.
+ 2) Removed packed struct optimization from PS_MMC.CPP.
+ 3) Changed debug print statements in D_MEDSDP.CPP so can distinguish
+ from D_MEDMMC.CPP.
+ 4) Fixed FID-54YK2B (MEDMMC buffer not DMA-safe.) Pages of physically
+ contiguous RAM are allocated by the EPBUS controller at bootup and
+ the media driver uses a virtual function to find out where they are.
+ Note this is a convenience for the principal EPBUS client, i.e.,
+ MEDMMC / MEDSDU. If other drivers want to be clients of EPBUS, they
+ should still allocate their own internal buffers.
+ 5) Fixed MBR.H header file to use include guards and #include <e32std.h>.
+ 6) Fixed FID-54VENJ (MMC: Same debug trace used for different functions.)
+ Changed debug text for DMMCStack::SchedGroundDown().
+
+2) Peter
+ 1) Added support on MMC Card Controller for mechanical write protect switch.
+ 2) Extended the local drive caps class (now extended to TLocalDriveCapsV3)
+ by adding two extra members:-
+ TUint iMediaSubType;
+ TInt64 iTotalDiskCapacity;
+ 3) Added support for multiple Peripheral Bus Controllers.
+ For all platforms other than WINS, these are now loaded as kernel
+ extensions which then register themselves with the kernel from
+ the extension DLL entry-point. Each Controllers register once for
+ each socket that it controls and the kernel supports up to
+ KMaxPBusSockets(4) sockets (i.e. the system could support four different
+ Controllers each managing a single socket, two different Controllers
+ each managing a pair of sockets etc). The Peripheral Bus Controller
+ DLLs have been renamed. All used to be build as EPBUS.DLL. Now PC Card
+ Controllers are built as EPBUSP.DLL and MMC Controllers are built as
+ EPBUSM.DLL. For non-WINS platforms, the kernel no longer links with the
+ Peripheral Bus object and a platform can be configured with multiple
+ Controllers, a single Controller or no Controllers simply by the inclusion
+ (or non-inclusion) of the Controller extension DLL in the rom OBY file. The
+ WINS and MEIG platforms now support dual Controllers, both a PC Card
+ Controller and an MMC Controller. (Note, to achieve this in WINS, the kernel
+ now links to EPBUSP.DLL and EPBUSM.DLL). Changes to support this include:-
+ a) Added the function:-
+ void Kern::RegisterPBusController(TPBusNum aMachineBusNum,
+ DPeriphBusController* aController,TPBusNum aControllerBusNum)
+ which should be called from the Controller extension DLL entry-point for
+ each bus that the Controller manages in order to register that Controller
+ for that bus. 'aControllerBus' is the number of the bus relative to that
+ particular Controller as opposed to 'aMachineBus' which is the bus number
+ relative to the entire machine (e.g. on a machine configured with two
+ Controllers each managing two buses, then when the 2nd controller registers
+ for it's 2nd bus, the machine bus number of this is 3, but the number relative
+ to the 2nd Controller is 1).
+ b) With there now being potentially multiple Controllers,
+ the function to retrieve the pointer to the Controller now takes a bus
+ number as a parameter and becomes:-
+ DPeriphBusController* Kern::PBusController(TPBusNum aMachineBusNum)
+ c) Added the function
+ TPBusNum Kern::PBusControllerBusNum(TPBusNum aMachineBusNum)
+ which returns the bus number relative to its owning Controller for a given
+ machine bus number.
+ d) The kernel now keeps a count of Controller registered. This means the
+ platform specific HAL function ImpHal::TotalSupportedBuses() is now
+ redundant and has been removed.
+ e) Modified the extension DLL entry-point function for the generic
+ Peripheral Bus Controller to allocate the Controller object and perform
+ secondary initialisation before registering the Controller with the kernel.
+ This makes the function P::InitialiseLocalDrives() redundant and it has
+ therefore been removed. Also, the function DPeriphBusController::NewL() is
+ no longer exported. (Still exported from WINS Controllers which aren't
+ extensions and therefore still need to to initialised directly by the kernel).
+ f) Removed the function DPeriphBusController::TotalSupportedDrives() and
+ replaced this with a straight call to the variant of the same name:
+ Custom::TotalSupportedDrives().
+ Following on from this, removed the data member iTotalSupportedDrives
+ from the classes TPcCardMachineInfo and TMmcCardMachineInfo.
+ g) Added the pure virtual function:
+ TPBusNum DPeriphBusController::BaseBusNumber()
+ to the generic Peripheral Bus Controller class which returns the
+ machine bus number of the first bus under the control of this Peripheral
+ bus Controller. Provided implementations of this in the DPcCardController
+ and DMMCController classes. These read the required information from the
+ corresponding TPcCardMachineInfo and TMmcCardMachineInfo classes. Added the
+ corresponding data member iBaseBusNumber to each of these classes which
+ is supplied from the variant.
+ h) Constructors for TPBusCallBack made inline rather than being exported
+ from the Peripheral Bus Controller so that the kernel no longer needs to
+ link with EPBUS.LIB.
+ i) Moved the function:
+ DPBusMediaDriver::SetCurrentConsumptionInMilliAmps()
+ to the Media Driver base class - DMediaDriver and removed the function
+ DMediaDriver::DeltaCurrentConsumptionInMilliAmps() which was now redundant.
+ Also added a destructor to the DMediaDriver class to reset the current
+ consumption when the object is destroyed. This again required in order that
+ the kernel need no longer link with EPBUS.LIB (as this needs to reset
+ the media driver current consumption on a media change - with object
+ destruction not occuring until the next mount).
+ j) Change to the WINS local drive mappings to include emulation of PC Card
+ drives as well as MMC drives.
+ The entire local drive mapping for WINS is now as follows:-
+ Local drive 0: Internal RAM drive (EFixedMedia0) - Y:
+ Local drive 1: 1st special MMC Card on MMC socket 0 (ERemovableMedia0) - X:
+ Local drive 2: 2nd special MMC Card on MMC socket 0 (ERemovableMedia0) - V:
+ Local drive 3: MMC Card on MMC socket 1 (ERemovableMedia1)
+ Local drive 4: PC Card on PC Card socket 0 (ERemovableMedia2)
+ Local drive 5: PC Card on PC Card socket 1 (ERemovableMedia3)
+ Local drive 6: Not currently assigned
+ Local drive 7: Not currently assigned
+ Local drive 8: Internal LFFS drive (EFixedMedia1) - W:
+ k) For MEIG, MISA and MTEMPLATE platforms, the Peripheral Bus variant interface has
+ been removed from the variant DLL and is instead built as a separate kernel extension - either
+ as EPBUSPV.DLL for PC Card Controller variants or EPBUSMV.DLL for MMC Controller variants.
+ For these platforms, registration of the Controller with the kernel takes place via a call
+ from the Controller variant extension DLL entry point rather than from the Controller extension
+ DLL entry point. For all other platforms, the Controller variant remains as part of the main
+ variant DLL. These platforms therefore have no separate Controller variant DLL.
+ As a result of this change, the Controller DLL entry
+ point has been moved out of the generic layer of the Peripheral Bus
+ Controller (PS_PBUS.CPP) into the ASSP layer.
+ Splitting the Controller variant out of the main
+ variant DLL is necesssary where there are multiple
+ Peripheral Bus Controllers on a platform - otherwise the variant DLL has to contain
+ multiple Controller variants.
+ l) Deleted V32PCCD.H, and V32PCCDI which were being used as a general definition of the
+ PC Card Controller variant interface for all platforms. Each peripheral bus ASSP layer
+ should define its own variant interface as required for that impelementation. This
+ should be defined in the header file \e32\epbus\epoc\<assp>\v32pccdv.h (or v32mmcv.h
+ for MMC Controllers). Implemented this for all supported platforms.
+
+ NOTE: The power model extension - EPOWER.DLL must be loaded before any Peripheral
+ Bus Controller extensions - EPBUS?.DLL or EPBUS?V.DLL (i.e. in the OBY file, the
+ lines that specify the inclusion of EPBUS??.DLL must occur after the line which
+ specifies the inclusion of EPOWER.DLL).
+
+3) RobertJ
+ 1) Changed string descriptor text in pa_usbc.cpp to remove reference
+ to EPOC and ER6.2
+
+ 2) Removed function CopyMaxToClient in d_usbc.cpp, this was in effect a
+ duplicate of CopyToClient. Code now uses CopyToClient in all cases.
+
+ 3) In usbdma.cpp & k32usbc.h changed interface to
+ TDmaBuf::RxCopyPacketToClient & TDmaBuf::RxCopyDataToClient to take
+ an explicit length argument. This removes the need to modify the
+ TEndpointTransferInfo
+ Modified d_usbc.cpp to reflect change in the calling interface to
+ TDmaBuf::RxCopyPacketToClient & TDmaBuf::RxCopyDataToClient
+
+4) MichaelP
+ 1) Fixed compile time error in /e32/drivers/ehwa/d_hwa.cpp which only occurred
+ when GETPUTDATA_ARE_KERNELSERVERCALLS had been #defined.
+ 2) Added parameter 'TInt aNumWindows' to functions DHwaTask::Init() and
+ THwaTaskHwInterface::Init(), which are declared in k32hwa.h.
+ 3) Introduction of boolean flag iInUse to class THwaDataTfReq: used to identify
+ transfer requests which are currently being processed by the PDD.
+ 4) HWA bogus PDDs: changed order of calls to DHwaTask::GetNextRequest to account
+ for change no. 3).
+ 5) Moved HWA device state member iStatus from class DHwaDevice to class
+ DHwaDevicePdd; maintaining its correct value is now up to the PDD.
+
+
+Version 1.02.365
+================
+(Made by AndrewJ, 12/12/2001)
+
+1) Morgan
+ 1) Integrated DPassiveDebugger enhancements from \tools\debugger_stub\...
+ into Helen variant: \helen\debugger\...
+
+2) ChrisM
+ 1) Fixed MET-54HLQA (T_NEWHAL tests fail)
+ 2) Fixed MET-555GLS (On WINS HAL function EDisplayMemoryAddress should return the Window Handle)
+
+3) Dennis
+ 1) Fixed HEY-54JJ9Y (DPlatLibrary not filled in for some loads)
+
+4) JonathanM
+ 1) Fix for 6.1 defect MOS-54NLHX - "__PROFILE_DISPLAY macro in e32def.h has error"
+
+5) WilliamRo
+ 1) Fixed ROS-54MGXX "WINSCW builds enable C++ exceptions and RTTI" by adding
+ appropriate #pragmas to the __CW32__ section of e32def.h
+
+6) Nicolas
+ 1) Fixed MOS-54QM2W (Building bootstrap MMU layer &
+ special bit patterns in permissions): The MMU
+ permissions are now global variables defined in the
+ variant part of the bootstrap and used by the generic
+ ones.
+ 2) Removed the write-through version of the generic
+ bootstrap MMU library. This was used only by the
+ Helen port which now uses the same code as everything
+ else and selects write-through behaviour by changing
+ the MMU permissions in the variant (see previous
+ entry). See commented out code at the top of helen.s
+ and helenc.cpp to switch between write-back and
+ write-through.
+ 3) Fixed THY-54XJFZ (When fast RAM used, cache should be
+ disabled for kernel stacks, data and heap). When
+ those entities are in DRAM, they are always cacheable.
+ When they are in FRAM, they are mapped using the map
+ flags specified in the FRAM bank. This allows to
+ enable/disable the cache on a per-bank basis.
+
+7) RobertJ
+ 1) Fixed HEY-54JME9. Removed mini-loader
+ "Drive specifier missing on libraries loaded with the mini-loader"
+
+8) MichaelP
+ 1) Removed /e32/drivers/ subdirectories ecommdma and emcbsp. These two drivers were
+ introduced by the Helen port and are actually TI-specific. Since they are not even
+ used by the current Helen port, we can safely get rid of them.
+
+9) PeterH
+ 1) Integrated changes to DEF files from the mainline.
+ Frozen exports are now marked with the R3UNUSED flag where appropriate.
+ This is to support the thumb stub optimisation where the R3 register is
+ use to generate a smaller import stub for a function if it isn't used to
+ receive parameters.
+
+10) MarkCa
+ 1) Updated MLNK EPBUS port to detect all events in ISR.
+ 2) Reduced EPBUS by c1.2k by using packed TMMCCommandSpec structure.
+
+Version 1.02.364
+================
+(Made by MichaelP, 20/11/2001)
+
+1) MarkCa
+ 1) Changed DFlashDevice::SetupWrite() in \integratorap\lffs\flashfile.cpp
+ to use wrapper class for testing if write buffer available instead of
+ testing bits in 32bit value.
+ 2) Fixed CAN-547HD3 (Controller panics when no events to handle.)
+
+2) RobertJ
+ 1) Corrected coding comments in d_usbc.cpp & minor clarification in pa_usbc.cpp
+ 2) Implemented new USB VID.
+ 3) Further cleanup work following deconfiguration on USB client SIN-535KPU
+ 4) Propagated fix for PBN-4TKJ7J "Bluetooth panics with HCI error 23".
+ In \brutusa\vi_com2.cpp, reordered ISR rx now done first
+ then tx, removed uart tx busy spin.
+
+3) Nicolas
+ 1) Fixed FID-53YD58 (Bootstrap doesn't dump all MMU
+ pages): off-by-one error.
+ 2) Enabled cache for exception vector page when it is in
+ DRAM (cache still disabled if the page is in fast RAM
+ as TC RAM and cache are not compatible).
+
+4) ChrisM
+ 1) Fixed ALM-53LHP4 (Fixed Calibration settings are not saved). Assabet only defect,
+ problem was in the variant vi_xyin.cpp in DDigitiserSA1100::DigitiserToScreen.
+ 2) Fixed FOD-54MET2 (Display bytesPerLine calculated as bits not bytes). Fixed the problem in template port + integrator.
+
+5) AndrewJ
+
+ 1) Fixed DOM-4XWC5P (Medlfs driver is not reliable) This problem was concerned with
+ flash devices not erasing properly when suspended, on assabet boards. This was
+ fixed by not suspending an erase unless both chips have gone into suspend mode
+ properly.
+ 2) Fixed FID-53YDJC (Error LFFS driver SetupWrite() function) Semi implemented
+ suggestion in defect report though still need to issue dummy command after
+ correct register has been read, otherwise command issued does not work.
+
+6) JonM
+ 1) Implemented change request JMET-544FUM - "Change RTransferWindow::MapInBuffer() to
+ return error code and not panic"
+
+7) CarlosF
+ 1) Fixed MOU-543FVR HAL attribute ECaseSwitch returns wrong value for Assabet.
+ The following files were modified:
+ \assabetb\hal\config.hcf
+ \assabetb\hal\values.hda
+ \assabetb\lffs\loadlffs.cpp
+ \assabetb\vi_hal.cpp
+ \hal\inc\hal_data.cpp
+ \hal\tsrc\t_new_hal.cpp.
+ Fixed FRS-534EWW T_SERIAL fails on Assabet. The following files were
+ modified:
+ \assabetb\bmisa\visaabu.def
+ \assabetb\v32scpld1111.h
+ \assabetb\vi_com1.cpp
+ \assabetb\vi_com3.cpp
+ \assabetb\vi_cpld1111.h
+ \assabetb\vi_hw.cpp
+ \assabetb\vi_power.cpp.
+
+8) MichaelP
+ 1) HWA API implementation now corresponds to API document version 0.15:
+ a) Removed enum TTaskPriority from d32hwa.h (was not used).
+ b) Two new functions in class RHwaTask:
+ TInt PutData(RTransferBuffer& aBuf, TInt aBytesToBeTransfered,
+ TInt* aBytesTransfered=NULL, TInt TransferId=KTfBufIdNull);
+ and
+ TInt PutData(RTransferBuffer& aBuf, TRequestStatus& aStat,
+ TInt aBytesToBeTransfered, TInt* aBytesTransfered=NULL,
+ TInt aTransferId=KTfBufIdNull);
+ which allow the user to specify the number of bytes to be transferred to the
+ DSP (rather than the whole buffer).
+ c) New member in class TTaskDataTfInfo (d32hwa.h): TInt iBytesToBeTransfered;
+ d) Renamed THwaPanic enums from EHwaXxx to EHwaPanicXxx (k32hwa.h).
+ e) Added virtual destructor for class THwaTaskHwInterface to prevent resource
+ leaking in derived classes.
+ f) Removed function TInt DHwaTask::Priority() (was not used).
+ g) New member in class THwaDataTfReq (k32hwa.h): TInt iBytesToBeTransfered;
+ h) Removed data member iPriority from class DHwaTask: moved to class
+ THwaTaskHwInterface; thus the task priority is now managed entirely by the PDD.
+ i) Added three additional arguments to TInt THwaTaskHwInterface::DoInputFrom(const
+ DHwaTask& /*aTask*/, TInt /*aOutputIndex*/, TInt /*aInputIndex*/,
+ TInt /*aConnectionId*/) to pass the task index and connection ID information to
+ the PDD.
+ j) Made function void DHwaDevice::SetStatus(THwaDeviceStatus aStatus) public
+ (was: protected).
+ k) Merged two functions of class DHwaDevice
+ TInt TaskCallPutData(DHwaTask* aTask, const TAny* aArg);
+ TInt TaskCallGetData(DHwaTask* aTask, const TAny* aArg);
+ into one function
+ TInt TaskCallTransferData(DHwaTask* aTask, const TAny* aArg, THwaDataTfDir aDir);
+ l) Fixed kernel heap memory leak caused by incorrect call to S::TransferWindowClose()
+ in destructor DHwaTask::~DHwaTask().
+
+ 2) USB client implementation:
+ a) Added "#define SET_DESCRIPTOR_REQUEST_SUPPORTED" to k32usbc.h (in commented-out
+ form).
+ b) Added "const TUint16 KUsbVendorId_Symbian = 0x0E22;" to usb.h (USB-IF assigned
+ Vendor ID).
+
+
+Version 1.02.363
+================
+(Made by Dennis 26/10/2001)
+
+1) MarkCa
+ 1) Updated Linkup MMC port with event checking asserts.
+ 2) Modified P32MMC.H to allow per-platform configuration. The file
+ can only be included into ASSP-specific builds. It reads a header
+ file MMC_CFG.H from \epoc32\include\kernel\ASSP.
+ 3) Fixed FID-4ZKEKQ (Inefficient memfill in MMC driver.) Use Mem::Fill()
+ instead of loops to fill buffers with 0xff in DoFormat() for
+ DMmcMediaDriverFlash.
+
+2) Nicolas
+ 1) Fixed THY-52WJTE (DLL static data support doesn't
+ allow for DLLs which only have BSS): The "$DAT" chunk
+ which holds the initial content of the DATA section is
+ not created when there is no DATA section.
+ Additionally it is not created for ROM-based DLLs as
+ the initial content is fetched from ROM in that case.
+ 2) Fixed generic bootstrap defect FID-53BKSD (920T
+ MMU_Invalidate is wrong): The ARM920T version of that
+ function now only invalidates TLB and I-cache.
+ 3) Fixed kernel defect THY-53FE32 (Confusion between
+ TheKernelPage and TKernelPage ctor)
+ 4) Fixed generic bootstrap defect THY-53LC9Y (crash when
+ only exception handlers and supervisor stack/heap in
+ IRAM). Reversed exception code and supervisor
+ heap/stack allocation order in fast RAM to ensure that
+ stack/heap always at top of bank where the bootstrap
+ stack is. Otherwise the adjusted stack value after
+ enabling MMU is wrong.
+ 5) Fixed generic bootstrap defect FID-53LKTG (Bootstrap
+ test code: heap test is useless, author should be
+ shot). Kernel data is now really checked.
+ 6) Modified bootstrap tests to take into account possible
+ exception vectors relocation to highmem.
+ 7) Removed deprecated "screensize" keyword from bootstrap
+ test obey files.
+
+3) ChrisM
+ 1) Fixed WIR-53FANN (RArrayBase::HeapSort makes assumption about max iEntrySize value)
+ Changed temp buffer in HeapSort functions to use the const KSimpleArrayMaxEntrySize
+ 2) Fixed MOS-53FLUF (HAL attribute ordering incorrect). Moved EPenState from
+ before EKeyboardState to after ESystemDrive.
+ 3) Fixed MOS-53RHP3v(Screen width and height returned by HAL are constant). Added func
+ to hal\src\emul.cpp to return the current sizes defined in epoc.ini.
+
+4) Carlosf
+ 1) Changes to Assabet Variant to fix a problem with the External Interrupts
+ dispatching. Modified \assabetb\vi_hw.cpp.
+ 2) Fixed BAN-52BKKC Physical device driver for serial port have a defect and
+ can cause loss of data.
+
+5) Pete
+ Migrated the fixes for the following 6.1 defects:
+ 1) Fixed PAS-4WRMQS: "Requeing a read() after PowerOn Panics the Driver/Kernel".
+ Problem caused by driver registering for PC Card IREQ events twice without
+ de-registering in between. This causes a panic in the PC Card Controller.
+ - Modified the Brutus and Assabet PC Card serial PDDs
+ (DITXBA4.PDD/DITXAB4.PDD) so that rather than registering and de-registering
+ for notification of PC Card IREQ events whenever they need to disable serial
+ interrupts, the drivers keep the notification request registered - and simply
+ enable and disable IREQ events on that socket.
+ - Changed the PC Card Controller so that registering a TPBusCallBack object
+ for event notification (with DPcCardController::RegisterEvent()) which is
+ already registered returns an error rather than causing a kernel panic.
+ - Modified the PC Card Controller by adding support for a new configuration
+ request flag: KPccdConfigOverrideNormalPwrEvents. If a configuration is
+ requested (via DPcCardController::RequestConfig()) which contains this flag
+ setting then normal machine power handling by the Controller for the socket
+ in question will be disabled - leaving the PC Card Controller client to
+ implement its own power handling policy. This only applies to machine power
+ on/ power off events. The Controller will continue to handle emergency power
+ down and media change events. The power handling override will remain in
+ force as long as the configuration is applied (i.e. this condition is removed
+ following a call of DPcCardController::ReleaseConfig(),
+ DPcCardController::DeregisterClient(), a media change event etc). This
+ feature is required to support PC Card serial cards in order to support the
+ 'idle off' power policy which serial ports now implement. Without this, even
+ though the PC Card serial driver will ignore a machine power down call when
+ it still has a write request in progress, the PC Card Controller will still
+ turn off the VCC supply to the card and thus power it down.
+ 2) Fixed SCE-534GAE: "Problems with Serial Comms LDD power handling"
+ - Modification to the serial port LDDs, ECOMM.LDD (including the WINS version)
+ and ECOMMDCE.LDD to fix a problem with the way it implements the 'idle off'
+ power policy. Although it currently ignores Power-Off notifications, it does
+ not ignore Power-On notifications and instead completes any outstanding request
+ with KErrAbort. Hence, if the machine happens to be powered off and then back
+ on again before the serial port has had an inactivity timeout, any outstanding
+ requests will wrongly be completed with KErrAbort as the machine turns back on.
+ - Another problem fixed is associated with the fact that the
+ current comms driver power handler doesn't actually power the
+ device down on a normal power down event. However, the driver
+ itself uses the power model at other times to control power
+ to the device (e.g. when closing the driver). Hence,
+ DChannelComm::DoPowerDown() is never called and the driver
+ closes leaving the comms h/w powered up. This is now fixed,
+ with the driver calling DoPowerDown directly when required.
+ 3) Fixed SCE-52YHQE: "Serial change notifier problems".
+
+6) WilliamR
+ 1) Fix defect ROS-53TDGG "Access Violation in CreateFirstDllRefTable" by allowing for
+ GetModuleHandleA to return 0. This is essentially the same code as used in
+ CreateDllRefTable() which handles dynamically loaded DLLs.
+
+
+Version 1.02.362
+================
+(Made by ChrisM, 05/10/2001)
+
+1) CarlosF
+ 1) Port defect fix for defect ALM-4VQB5V Ditizer freezes (was: The Brutus
+ board freezes after entering 50-60 characters with HWR) from 6.1.
+ Modified \assabetb\vi_xyin.cpp and \brutusa\vi_xyin.cpp.
+
+2) MarkCa
+ 1) Fixed FID-4ZWDMZ (MMC program poll is too slow to be useful.)
+ Use TMilliSecondCallBack instead of TTickLink. Pure virtual DMMCStack
+ function ProgramPollPeriod() replaced with pure virtual DMMCController
+ function ProgramPeriodInMilliSeconds().
+ 2) Moved Integrator LFFS drive to k:. ImpHal::TotalSupportedDrives() now
+ returns 9 instead of 2, as does unused Variant::PeriphBusMachineInfo().
+ MEDLFS changed to use 22MB of flash across three pairs of chips.
+ The memory range is a contiguous block, which can be specified at
+ compile time in \integratorap\lffs\ffs_config.h.
+
+3) JonM
+ 1) Fixed defect FER-4XDK9G - "Assabet timers go off at strange intervals."
+ 2) Fixed defect MET-52AF29 - "Power off/on may freeze Assabet/Brutus"
+ 3) Fixed defect in TSa1100::SetRtcData. This needed to wait longer for the new value to take effect.
+ 4) Moved HELEN's exported headers from E32 to the HELEN variant.
+ This helps fix defect MAY-4XWM9Q - "e32 does not build in an IPR-E OCK".
+ It also moves what should probably be IPR category B stuff from a cat E directory.
+
+4) MichaelP
+ 1) HWA API implementation now corresponds to API doc version 0.14
+ a) THwaTaskHwInterface::DoCloseTask() now has a parameter TBool
+ aCallbackRequest which indicates whether or not the PDD should
+ finally call DHwaTask::CloseComplete()
+ b) RHwaTask::Logon() now has a second parameter TUint aFlagsWord which
+ can be used to make a logon request more specific
+ c) RHwaTask functions Start(), Suspend(), Resume(), and SetPriority()
+ are now asynchronous; however this is transparent to the user as the
+ asynchronousness is wrapped up in the d32hwa.inl inline header file
+ d) Renamed DHwaTask::DoLogonComplete() to LogonComplete()
+ 2) USB PIL: Endpoint Data Toggles are now correctly reset after Set_Interface and
+ Set_Configuration requests.
+
+5) AndrewT
+ 1) Fixed BAN-52BKTN (CAsyncCallBack ctor TCallBack& could be const). Made
+ the TCallBack parameters to the constructor and Set() const.
+ 2) Fixed BAN-52BKV2 (Should inline TInt RSubSessionBase::SubSessionHandle() be
+ const?). Added const to this member.
+ 3) Fixed THE-52WJR6 (Equality operators for TThreadId and TProcessId should be
+ const). Made the accessor and comparison operators const on these classes.
+6) RobertJ
+ 1) Incorrect behaviour in usb client after getting deconfigured then
+ configured, without an intervening reset.
+ Data toggles were not getting reset,
+ ldd wasn't cancelling user requests,
+ PIL layer wasn't cancelling ldd requests and
+ psl layer was trying to drain fifo because RPE bit was set.
+ RPE will get reset on next read when RPC gets cleared and fifo is
+ automatically emptied.
+ 2) Fixed FID-52HBTA: USB driver not leave safe
+ 3) Fixed ROS-534EAV: usbdma.cpp mixes new[] and delete
+
+7) ChrisM
+ 1) Fixed PAR-52CLSB (920T bootstrap code is Cat D it should be Cat E). Changed
+ categorisation to E after source code recategorisation CR - CMOS-52WJ5V
+
+
+8) Pete
+ 1) Removed Cogent source
+ 2) Removed Windermere source
+ 3) Removed MEDCRM and MEDCRR media driver source.
+
+Version 1.02.361
+================
+(Made by AndrewT, 31/08/2001)
+
+1) AndrewT
+ 1) Fixed EDNATHE-4QQKZM (RThread().Suspend() deadlocks the emulator) again.
+ The original fix was incomplete.
+ 2) Fixed HEY-4XHGD5 (Remove \e32\include\K32DBGDD.H)
+ 3) Fixed MET-4YSM3M (Text shell DIR command problems)
+
+2) Nicolas
+ 1) Fixed FID-4VHGDK (Debug should show current thread
+ after exception). When a thread or process panics or
+ takes an unhandled exception, the name and ID of the
+ thread/process is displayed in the kernel traces (only
+ if KPANIC is set).
+ 2) Replaced void GetExceptionVectorsInfo(addr, size) with
+ TUint32 ExcVectorsAddr() in generic bootstrap because
+ vector table size not used anymore. Documented that
+ in bootstrap doc version 1.2.
+ 3) Small changes following RHR 113.2 (exception code in
+ fast RAM) review.
+ 4) Exception vectors are now moved to highmem on assabet.
+ 5) Updated makefiles used to build bootstrap tests for
+ MLNK, MINT and VTEMPLATE now that the generic test
+ code is contained in libraries.
+
+3) Chris
+ 1) Fixed problem with cirrus not turning display on introduced with LCD changes for GT111
+ 2) finished implementation of mapping video chunk from more than one physical region
+ 3) Updates to video driver code from code review. Split video driver up into bit which needs porting and the interface.
+ 4) Changes to video driver for CR LROS-4Z7E7Z to allow scdv get all display modes
+ 5) updated video test code to include tests for palette when not in palettized video mode and updated assabet and brutus
+ to report if backlight is supported via HAL and fixed inconsistency between assabet,brutus and the template reporting
+ different error value if palette functions called on a none palettized video mode.
+ 6) Fixed FID-4ZGJ2L WINS/WINC doesn't handle command line args correctly. If executable command path
+ has spaces it will be quoted. If a quote is found it skips until the next one.
+ 7) Fixed MOS-4Y4D9K Two taps on screen required to turn on display.
+
+4) AndrewJ
+ 1) Fixed THY-4YCP96 stopped Null pointer from being derefrenced in LFFS media driver
+
+5) JonM
+ 1) Fixed defect FID-4WUGL4 - "MMU secondary config is annoying"
+ The MMU secondary config is now obtained from a constant (KMmuSecondaryConfig) contained
+ in the bootstrap's variant library.
+ 2) Fixed defect FID-4XTC27 - "Bank width corrupted in BDB"
+ 3) Fixed defect FID-4Y3CP3 - "Should fill unused Rom config blocks"
+ 4) TransferBuffer performance greatly improved.
+ 5) API CHANGE: DTransferWindow::MapInBufferL is now non-leaving and has been
+ renamed to MapInBuffer.
+ 6) Fixed bug in DPlatProcess::RemoveChunk, this no longer flushed the data chache
+ when removing EFixedAddress chunks.
+ 7) Extended T_HWA test to include a benchmark test for PutData. Also made this
+ work on Integrator.
+ 8) Fix for defect PAR-4VMKV7 - "WD_VT100 has lost its basic nature and now depends on the Comms drivers!!"
+ WD_VT100.CPP Has now reverted being output only, via the debug port.
+ The implementation using the ECOMM driver has been added as WD_VT100_ECOMM.CPP
+ 9) Fix for defect FID-4YTET9 - "Manufacturer in HAL should be a UID"
+ (Made TManufacturer definition obviousely extendable by using UIDs.)
+ 10) Fixed defect SAS-4ZTD5D - "Missing l7200a t_trace.cpp file for bootstrap tests"
+ Also fixed build failure with Integrator bootstrap test code.
+ 11) Fixed defect SAS-4ZSGBU - "Exports inconsistent. v32isaab.h includes not exported"
+ 12) Fixed defect FER-4XGDVT - "Integrator can't cope with time being set randomly"
+ 13) Removed #include <e32transbuf.h> from e32std.h
+
+6) MarkCa
+ 1) Implemented MEDLFS driver for Integrator. Mounts on local drive 1
+ and provides access to 2 * 4Mb flash chips. ELFFS is not mounted
+ by default.
+
+7) CarlosF
+ 1) Changes to Assabet bootstrap and Variant to make Assabet's CPU and Memory
+ bus clock speed configurable. Also includes an option to always format the
+ C:\ drive on start-up if LFFS filesystem is mounted on this media.
+ 2) Changes to SA1100 ASSP to enable WAIT signal detection on Assabet PCCard
+ IO accesses. This is required as the Assabet controller needs to be
+ configured to detect the assertion of this signal on accesses to IO space
+ contrary to Brutus which has this detection enabled by default.
+
+8) TimBa
+ 1) Folding now folds 0xA0 (non-breaking space) to normal space (0x20)
+
+9) Andy Curran (Uikon)
+ 1) Fix for (PER-4Z5DW6) Switch On/Off Control Panel Dialog case closed option does not work.
+ Really just correcting a few typos. Fix tested with success. Fix accepetd by Nicolas T.
+
+10) MichaelP
+ 1) Updated Helen port (mhelen target) to 6.1 port sources from 30 July
+ 2001 (Perforce revision 10426). Many changes, among them items 2) - 6).
+ 2) Added directory stdarmWT (containing some files) under /bootstrap/mmu/:
+ "Bootstrap MMU Write-Through Mode."
+ 3) Added directory ecommdma (also containing some files) under
+ /e32/drivers/: "Implements the Logical device driver for a serial port
+ using DMA transfers." This driver is used by the mhelen target.
+ 4) New kernel exports for mhelen:
+ THelen::ReadIntMask(unsigned int);
+ THelen::SetMcBspReg(unsigned int, unsigned int, unsigned int);
+ THelen::SetComBSPStatus(int);
+ 5) Re-activated #define __EARLY_DEBUG__ in
+ \e32\ekern\epoc\arm\Helen\KA_UTL.CPP.
+ 6) Added file \e32\rombuild\HelenTests.oby.
+ 7) HWA API: RHwaTask functions GetData / PutData are now kernel exec calls
+ (as opposed to kernel server calls) --> significant performance
+ increase.
+ The previous behaviour (i.e. server calls) can be had by uncommenting
+ //#define GETPUTDATA_ARE_KERNELSERVERCALLS in d32hwa.h.
+ 8) HWA API: Constant value changed: KTfBufIdNull = 0x0 (was: 0xf0000000).
+ 9) Added overloaded function
+ DTransferWindow* Kern::TransferWindowFromHandle(TInt aHandle, DThread* aThread);
+ to \e32\include\k32std.h, exported and frozen for all targets. Function
+ is implemented in \e32\ekern\ks_transbuf.cpp. This function is used
+ where the current thread is not the same as the one that created the
+ window handle.
+ 10) T_HWA has now integrated profiling support, activated by calling "t_hwa
+ profile".
+
+11) RobertJ
+ 1) Added a new constructor each for RArray and RArrayPointer. This enables
+ the sort/find to be used with an existing array with memory allocated
+ outside of these classes.
+
+
+Version 1.02.360
+================
+(Made by Peter, 06/08/2001)
+
+1) MarkCa
+ 1) Fixed FID-4X8JKB (TMMCCommandDesc::Direction() should be const.)
+ 2) Fixed MMC controller defect in ExecCommandSM() / EStDeselectEndCheck
+ where cmd was not reset after the stack was popped.
+ 3) Optimized DMMCcontroller::PowerUpBus() to initialize stack once for
+ all drives. Check if initialized successfully and still powered up.
+ If so, complete immediately. Retain ability to power down and power
+ up again if failed because of unknown password (CMD3 RTO.)
+
+2) Chris
+ 1) Changed brutusa\video.mmp to use visaba.lib not visaab.lib and cixyba.lib not cixyab.lib
+ 2) Updated headers and removed dead code from files changed for LCD driver improvements.
+ 3) Removed "screensize" keyword from header.iby files
+
+3) AndrewT
+ 1) Fixed NEO-4X8CFY (TTime::WeekNoInYear() function returns wrong
+ week number if week start day is not monday). Rewrote the
+ second half of the offending function to do the right calculations.
+
+4) Michael
+ 1) Commented out #define __EARLY_DEBUG__ in
+ \e32\ekern\epoc\arm\Helen\KA_UTL.CPP.
+ 2) Deleted line "screensize=320x240x12" from
+ \e32\rombuild\mhelen\header.iby.
+ 3) Added to \hal\inc\hal_data.h enum TManufacturer
+ "EManufacturer_TexasInstruments" and enum TMachineUid
+ "EMachineUid_Helen=0x101F3EE3".
+ 4) HWA API:
+ a) Introduction of concept of input and output index for tasks with
+ multiple I/Os. These indices are additional (& optional) arguments for
+ RHwaTask functions InputFrom(), DisConnectInput(), InputConnection(),
+ and OutputConnection(), and are also part of class TTaskConnectInfo.
+ b) New RHwaTask querying functions: GetTaskProperties() and
+ GetTaskStatus().
+ c) With these come two new classes: TTaskPropertyInfo (this not new but
+ updated), and TTaskStatusInfo.
+ d) RHwaDevice::Tasks() now returns a find-handle -- the handle is no
+ longer a component of the filled TTaskPropertyInfo structure.
+ e) RHwaDevice::CreateTask() has an additional parameter aNumWindows (#
+ of transfer windows for DHwaTask object).
+ f) RHwaTask functions Logon() and LogonCancel() are now void.
+ g) RHwaTask::SetOwningDevice() is now a protected class member and no
+ longer documented in the API doc.
+ h) Class RHwaDevice is now a friend of class RHwaTask.
+ i) Removed RHwaTask functions GetStatus() and GetTaskID().
+ j) Removed RHwaTask default constructor (was empty).
+ k) Removed enum THwaTaskLogon (was not used).
+
+5) Nicolas
+ 1) Modified MCOY bootstrap to take into account the super
+ and CPU pages layout changes introduced in E32 359.
+ 2) MCOY ASSP layer now contains static arrays for the
+ various stacks and initialises the PP::* and Arm::*
+ stack "top" pointers. Note that it would be possible
+ to perform the stack allocation in the bootstrap
+ instead.
+ 3) Fixed MAY-4V4E5V (Breakpoints don't work on ARM
+ architecture 5 processors). Now two opcodes in the
+ undefined space are used: a 16 bit one for THUMB and a
+ 32 bit one for ARM (previously a unique 16 bit pattern
+ was used). RDebug::SetBreakPoint() has now a new
+ overload which allows to specify what kind of
+ breakpoint is excepted. The old overload is
+ deprecated (it returns KErrGeneral systematically).
+ 4) Cosmetic changes to bootstrap and kernel following
+ code review.
+ 5) Removed dubious assert from bootstrap which crashed
+ Brutus when warm-booting: MarkRamImageInBank() can
+ actually be called with a BDB containing
+ KBdbBankTypeRamAsRom in that case because the BDB
+ initialised during cold boot is reused. This allows
+ to skip bank size/width detection.
+6) William
+ 1) Add CleanupArrayDelete template to E32BASE.H, and remove the __EPOC_CLEANUP_SUPPORT__
+ include guards to complete Epoc32 Proposal SW1-87 (See STORE 0049 notes from 1998)
+ 2) Export EKDATA.DEF so that ASSPs can get it from a published place, rather than
+ referring to ..\e32\bmarm\ekdata.def. Modified various MMP files to get this file
+ from \epoc32\release\marm\ekdata.def instead.
+
+7) Pete
+ 1) Fixed FID-4XEE3C "Remount of fixed media broken". Change to the function
+ DPrimaryMediaBase::NotifyMediaStatusChange() which is called on media
+ change, but more significantly when forcing a remount on a drive. The change
+ involves only attempting to reset media driver current consumption if the
+ media is removable (since only drivers for removable media track current
+ consumption). This fixes a problem where the kernel heap became corrupt when
+ forcing a remount on a fixed drive.
+ 2) Added the following functions to the TBusLocalDrive class:-
+
+ a) TInt SetMountInfo(const TDesC8* aMountInfo,TInt aMountInfoThreadHandle);
+ The SetMountInfo() function allows a descriptor to be associated with
+ a local drive - which is passed down to the corresponding media driver for the
+ drive as that driver is opened. This therefore provides a means of supplying
+ additional information to the driver at creation time. In the case of 'secure'
+ drives, a driver may not open successfully unless the correct mount information
+ is supplied at creation time. Mount information, once passed into the drive, is
+ stored in the correspnding DPrimaryMedia object for the drive and is therefore
+ available for subsequent remounts of the drive following media change or machine
+ power down events. Mount information can be cleared by passing in a NULL mount
+ info descriptor.
+
+ b) TInt ForceRemount(TUint aFlags);
+ This forces a local drive to be remounted. This is a replacement for the
+ function UserSvr::ForceRemountMedia(TMediaDevice aDevice) since the latter
+ requires knowlege of the h/w platform in quesion in order to select the
+ appropraite TMediaDevice value for a particular drive.
+ 3) Added SetMountInfo() function to TLocDrv class and modified TLocDrv::Open()
+ so this no longer takes a 'const TDesC* aMountInfo' parameter. Corresponding
+ change to DMedia::Open() function which also no longer has a
+ 'const TDesC* aMountInfo' a parameter. The mount info is intead stored in the
+ DPrimaryMedia class which has two new functions:-
+ TInt SetMountInfo(TLocalDriveMessageData &aMountInfo,TInt aMediaNum);
+ TMediaDrvDescData* MountInfo(TInt aMediaNum);
+ 4) Change to DMediaDriver class which now supplies the DoCreate() function and instead
+ requires a derived driver class to supply the pure virtual function:-
+ Int Open(TMediaDevice aMediaDevice).
+ In most cases, convertion of existing non-removable drivers will require the existing
+ DoCreate() function to be renamed Open().
+
+
+Version 1.02.359
+================
+(Made by JonathanM, 18/07/2001)
+
+1) Morgan
+ 1) Implemented CR MHEY-4XHN9D "Move DPassiveDebugger implementation out
+ of the core kernel"
+ Exported the following functions and K32DBG.H
+ ImpMmu::AllocatePageTable(unsigned long, unsigned long, int)
+ DPlatProcess::DataSectionBase(DPlatChunk *) const
+ ImpMmu::FreePageTable(int, int)
+ Moved ka_edbg.cpp from all ASSPs and
+ \e32\ekern\epoc\arm\kc_edbg.cpp into a device-driver/extention in
+ \tools\debugger_stub\passivestub\...
+ 2) Removed DDebugger initialisation calls from boot.
+ A DDebugger implementation should load itself as an extension or a
+ device driver, and install using Plat::SetDebugger(debugger);
+ 3) Added __ENABLE_NOTIFY_DEBUGGER__ macro to enable/disable debug support
+ in the kernel. Currently on in UREL and UDEB builds by default.
+ 4) Cogent passive debugger now lives in \tools\debugger_stub\passivestub
+ and is built as EDEBUG.LDD. Include this as an extension to get
+ Lauterbach OS aware debug. Or load it as an LDD with DEBUGGER.EXE
+ "DEBUGGER load" from the command line
+ 5) Helen debugger now lives in \helen\debugger and built as EDEBUG.LDD
+ See 4) for usage.
+
+2) Nicolas
+ 1) The kernel data/bss section can be relocated to any fast
+ RAM bank by setting KBdbFlagKernelData in the
+ appropriate BDB bank descriptor (generic bootstrap
+ only).
+ 2) The supervisor stack/heap can be relocated to any fast
+ RAM bank by setting KBdbFlagSvStackHeap in the
+ appropriate BDB bank descriptor (generic bootstrap
+ only).
+ 3) The kernel stacks (reentrant, null, irq, fiq, exception)
+ can be relocated to any fast RAM bank by setting the
+ relevant bit (KBdbFlagStack*) in the appropriate BDB
+ bank descriptor (generic bootstrap only).
+ 4) The kernel stacks are now allocated by the generic
+ bootstrap (either in DRAM or fast RAM). Super and CPU
+ pages layout modified to pass stack info to the kernel.
+ Each variant using the generic bootstrap calls
+ Arm::Init1Stacks() from ImpHal::Init1() to initialise
+ the stacks.
+ 5) For the windermere port which does not use the generic
+ bootstrap, the stacks are statically allocated in the
+ ASSP layer and ImpHal::Init1() initialises the
+ Arm::*StackTop and PP::*StackTop pointers.
+ 6) The exception vectors, handler and dispatch table can
+ be relocated to any fast RAM bank by setting
+ KBdbExcCode4k in the appropriate bank descriptor
+ (generic bootstrap only). There also exist
+ KBdbExcCode8k and KBdbExcCode12k in case the exception
+ handlers get bigger in the future.
+ 7) The exception vectors are now located at 0xFFFF0000 on
+ platforms which support this. Grep for
+ __CPU_EXC_VECTORS_MOVABLE in u32std.h for a
+ comprehensive list. As a consequence dereferencing
+ NULL pointers in privileged mode now enters the debug
+ monitor.
+ 8) Fix defect CLE-4Y4EMG (Bootstrap doesn't fill in Rom
+ config section completely): ROM type fields now
+ correctly initialised in the super page.
+ 9) Bootstrap test code added for assabet.
+ 10) Bootstrap documentation updated.
+ 11) Template port updated.
+
+
+3) Michael
+ 1) Fixed Helen crashing (exc id 26) at boot-up time: ImpHal::Idle() in
+ \e32\ekern\epoc\arm\Helen\KA_UTL.CPP
+ 2) Modified macro test() in e32test.h such that it now also displays the
+ respective source filename when an RTest test fails. Added the necessary
+ overloaded operator() and constructor to class RTest in us_test.cpp.
+ An occasional stack overflow problem has been fixed: we now pass the filename
+ string as a const TText* rather than a const TDesc& (_S() vs. _L()).
+ 3) Fixed DPlatChunk::SetContiguousRamL() and DPlatChunk::SetHardwareL() in
+ \e32\ekern\epoc\kp_chk.cpp: too much memory was reserved upon creation of a
+ transfer buffer, too little freed after closing it.
+ 4) Fixed CBitMapAllocator::ExtractRamPages() in \e32\euser\cbase\ub_bma.cpp:
+ eliminated a condition when the do/while loop would never be left.
+ 5) added two exported static kernel functions: DThread* Kern::SvThread() and
+ DProcess* Kern::SvProcess(), frozen for mawd, mcga, mcoy, meig, mhelen, mint,
+ misa, mlnk, mtemplate, wins
+ 6) HWA API:
+ - changed task parameter TaskID from type TInt to TUid
+ - RHwaTask::Close() and RHwaDevice::CloseTask() now return an TInt error code
+ from the kernel (actually from the PDD), rather than being void
+ - T_HWA: creating a contiguous transfer buffer from the user side now works,
+ added test of task messaging functions, misc. fixes.
+
+4) Tim Band and Arun Sachamuneewongse
+ 1) Added three 'next favourite' language specifiers to TLocale and
+ SLocaleData, and setters and getters for them in TLocale.
+
+5) JonathanM
+
+ LCD Driver Portability Enhancements
+
+ Moved all display related code into new kernel extension (VIDEODRIVEREX)
+ New LDD stub (VIDEODRIVERLDD) provides access to this implementation.
+
+ Added HAL attributes
+
+ EDisplayIsMono, // Display is monochrome
+ EDisplayIsPalettized, // True if display is in a paletized mode
+ EDisplayBitsPerPixel, // Number of bits per pixel for current display mode
+ EDisplayMaxBitsPerPixel, // Max color resolution display mode
+ EDisplayMemoryAddress, // Start of video memory
+ EDisplayOffsetToFirstPixel, // Offset of first displayed pixel from EDisplayMemoryAddress
+ EDisplayOffsetBetweenLines, // Number of bytes between the first pixel in successive lines
+ EDisplayPaletteEntry, // To get, pass entry number (Color returned as 0x00bbggrr)
+ // To set, pass entry in bits 31-24, color in bits 23-0
+ EDisplayIsPixelOrderRGB, // True if physical pixel layout is RGB, false for BGR
+ EDisplayIsPixelOrderLandscape, // True if physical pixel layout is landcape, false for portrait
+
+ Added new exports to EKERN
+
+ DPlatChunkHw::DoCreateL(class TPhysAddrs* aAddr,TInt aCount,TChunkType aChunkType)
+ TBool Plat::CheckInWservThread() // Returns true if current thread is the registerd WSERV thread
+ void Hal::SetDisplaySizeInPixels(const TSize& aSize) // Inform kernel of display size in pixels
+ void Hal::SetPhysicalScreenSize(const TSize& aSize) // Inform kernel of display size in twips
+ void Hal::SetMaximumDisplayColors(TInt aMaxColors) // Inform kernel of number of phsysical colors
+
+ Removed the following methods
+
+ ImpHal::DisplaySizeInPixels()
+ ImpHal::PhysicalScreenSize()
+ ImpHal::MaximumDisplayColors()
+
+ Hal::DisplaySizeInPixels()
+ Hal::PhysicalScreenSize()
+
+ ImpPsu::DisplayOn()
+
+ Custom::DisplaySize();
+ Custom::PhysicalScreenSize();
+ Custom::DisplayOn();
+ Custom::DisplayOff();
+ Custom::MaximumDisplayColors()=0;
+
+ P::ClearScreen()
+
+6) JonathanM
+
+ Fixes for base release.
+
+ 1) Updated E32 and F32 version numbers.
+ 2) Added IPR Policy files to base\assabetb\bootstrap\test (Category E)
+ and base\helen\debugger (Category B).
+ 3) Fixed WINS EDISP build warning.
+ 4) Changed T_VIDEO so that it doesn't build for WINS.
+ 5) Modified OBY files for varients which now use the new VideoDriverExtension.
+ These now have "#define USE_VIDEODRIVEREXTENSION"
+ 6) Removed spuriours Kern::Printfs.
+ 7) Renamed Integrator VideoDriverExtension to match romkit name pattern.
+ 8) Fixed bug in MISA videodriver GetPaletteEntry function.
+ 9) Removed always on tracing from brutus screen driver code.
+ 10) Fixed Integrator ROM building (needed to include video driver by correct name
+ and exclude the old Neon250 kernel extension.
+
+
+Version 1.02.358
+================
+(Made by Michael, 19/06/2001)
+
+1) MichaelP
+ 1) Added (many) and modified (some) files for the MHELEN ASSP base port.
+ 2) Modified macro test() in e32test.h such that it now also displays the
+ respective source filename when an RTest test fails. Added the necessary
+ overloaded operator() and constructor to class RTest in us_test.cpp.
+ 3) Reverted the change of the test() macro mentioned under 2) because of stack
+ overflow problems with some programs which were detected during the link
+ stage. This needs to be further investigated. For the time being we use the
+ old version of test().
+ 4) Updated HWA driver (LDD + WINS PDD) and API code. Added (bogus) PDD for Helen.
+
+2) Nicolas
+ 1) rom.cfg: suppressed no-header option for integrator.
+ 2) Fixed defect FER-4XDH9P (Switch On messages not
+ received) on WINS by calling Power::SwitchOn() when
+ waking up following normal or emergency standby.
+ 3) Deleted Eiger custom bootstrap because the port
+ actually uses the generic one.
+
+3) MarkCa
+ 1) Fixed EDNHLJT-4WZGTD (Secure mmc - "Invalid" after cancelling pw change
+ & FM panic) and related EDNHAAO-4WZFYR (Secure MMC: Note "Invalid" shown
+ after updating the file system.) New media attribute KMediaAttHasPassword
+ shadows PWD_LEN != 0 in card, and controller backs up store before
+ password operation, recovering on failure.
+ 2) Fixed CAN-4WJHJN (6.0) and EDNMCAN-4VYKTY (6.1) ("File server must accept
+ new MultiMediaCard password encoding scheme".) Password notifier
+ changed to encode passwords as Unicode.
+ 3) Enabled debug password notifier for F32 fix EDNPCHY-4VWP5B
+ (problems with secure mmc implementation.) This completes after
+ a user specified period and is used to debug using F32 when a
+ notifier is raised.
+ 4) Implemented CR PSCE-4VMP3K to set hard limit for RAM drive. New HAL
+ attribute EMaxRAMDriveSize must be set to size in bytes, where value
+ includes FAT.
+
+4) TimBa Fixed bug in MatchF: if argument was an empty descriptor, it always
+ returned null. Now if the candidate is nonempty it returns KErrNotFound.
+
+Version 1.02.357
+================
+(Made by Carlos, 31/05/2001)
+
+1) William
+ 1) Change DebugThreadPanic to use a struct for the debugger-friendly values, so that
+ a simple autoexp.dat change will display the panic details properly.
+
+2) Dennis
+ 1) Fixed defect HAR-4WSGJ5 (RArray::FindInUnsignedKeyOrder not returning KErrNotFound).
+ This was due to problems with the special case handling of 4 byte entries in the ARM
+ assembler version.
+ 2) Fixed problem with MCOY failing to boot when image was loaded using RedBoot
+ instead of RT bootloader.
+ There were two problems - a spurious CIU interrupt and the fact that the RTC correction
+ and LastSetTime were uninitialised.
+
+3) Nicolas (RHR 113.1 completly implemented)
+ 1) 5mx: Set LCD contrast to its default level every time
+ the screen is switched on. This works around the
+ regression introduced while cleaning up the Hal class (p4 changelist
+ (the screen was completely black and unusable).
+ 2) Fixed typo in ImpMmu::UnmapPage(): confusion between pde and pte.
+ 3) Added support for TC RAM banks in generic bootstrap.
+ Hardware-specific initialisation is left as an
+ exercise to the system integrator. It should be done
+ in HWInitialise().
+ 4) Added new consistency checks in generic bootstrap
+ (ROM/RAM bank ordering, bank overlap in
+ physical/linear space). Enabled for UDEB only.
+ 5) Partially implemented scheme allowing to fake IRAM on
+ assabet (disabled).
+ 6) Reorganised bootstrap test code: generic code moved
+ from brutusa to bootstrap.
+ 7) Ported bootstrap test code on assabet.
+
+4) JonathanM
+ 1) Added a new export to the BLD.INF files for BRUTUSA and ASSABETB.
+ VI_POWER.H is now exported to KERNEL\SA1100\ to enable the sound drivers to
+ set their power requirements.
+
+5) AndrewCu
+ 1) Small changes to the RNotifier class in e32 (for Uikon 6.2 Dialog Server work).
+
+6) Tim Band
+ 1) Changed TChar functions that query the type of the character so that
+ they do not make an Exec call
+ 2) Made Private Use Area characters graphical and printable according
+ to their meaning
+ 3) New folding code that respects Unicode
+ 4) Removed Uzbek, Tajik and Azerbaijani from language list, added
+ Tagalog in place of Azerbaijani
+
+7) CarlosF
+ 1) Several changes to Assabet Variant to get LFFS to mount on C:\ drive. This ended up
+ being made configurable, Switch 4 of the switch-pack on the Companion Chip Card
+ is used to decide wheter to Mount FAT or LFFS on drive C:\.
+
+1) Nicolas (RHR 113.1 completly implemented)
+ 1) 5mx: Set LCD contrast to its default level every time
+ the screen is switched on. This works around the
+ regression introduced while cleaning up the Hal class (p4 changelist
+ (the screen was completely black and unusable).
+ 2) Fixed typo in ImpMmu::UnmapPage(): confusion between pde and pte.
+ 3) Added support for TC RAM banks in generic bootstrap.
+ Hardware-specific initialisation is left as an
+ exercise to the system integrator. It should be done
+ in HWInitialise().
+ 4) Added new consistency checks in generic bootstrap
+ (ROM/RAM bank ordering, bank overlap in
+ physical/linear space). Enabled for UDEB only.
+ 5) Partially implemented scheme allowing to fake IRAM on
+ assabet (disabled).
+ 6) Reorganised bootstrap test code: generic code moved
+ from brutusa to bootstrap.
+ 7) Ported bootstrap test code on assabet.
+
+
+Version 1.02.356
+================
+(Made by Pete, 10/05/2001)
+
+1) MarkCa
+ 1) Added base support for store LFFS optimization. KDriveAttTransaction
+ bit added to \e32\include\e32std.h.
+
+2) Dennis
+ 1) Added mouse driver and VGA video driver for Integrator.
+ 2) Renamed the text window server DServer object to "TextWindowServer".
+
+3) Morgan
+ 1) Implemented Silent Running on Assabet
+
+4) Pete
+ Further changes to MMC Controller:-
+ 1) Renamed the function
+ DMMCSession::FillCommandDesc(TMMCArgumentTUint32,TUint8*,TUint32) to
+ FillCommandArgs() since it doesn't actually result in the command descriptor
+ array being updated.
+ 3) Removed check from DMMCStack::IssueCommandCheckResponseSM() whether
+ a multiblock read/write command has been selected with a total length less than
+ a block. This is redundant.
+ 4) Modified DMMCStack::CIMReadWriteBlocksSM(). This
+ function no longer sets up the command descriptor array for special block transfer
+ commands (but expects this to have been already done before the function is called).
+ 8) Further change to the WINS local drive mappings. The entire local drive mapping for
+ WINS is now as follows:-
+ Local drive 0: Internal RAM drive (EFixedMedia0) - Y:
+ Local drive 1: 1st special MMC Card on MMC socket 0 (ERemovableMedia0) - X:
+ Local drive 2: 2nd special MMC Card on MMC socket 0 (ERemovableMedia0)
+ Local drive 3: MMC Card on MMC socket 1 (ERemovableMedia1)
+ Local drive 4: Not currently assigned
+ Local drive 5: Not currently assigned
+ Local drive 6: Not currently assigned
+ Local drive 7: Not currently assigned
+ Local drive 8: Internal LFFS drive (EFixedMedia1) - W:
+
+5) Pete
+ 1) Modified bootstrap for Cirrus7211a so that this now runs at 36MHz.
+
+6) Nicolas
+ 1) Added fixed size internal RAM banks in generic
+ bootstrap.
+ 2) Introduced support for area relocation in generic
+ bootstrap. Every kind of file (including the primary)
+ can be relocated to an internal RAM bank.
+ 3) Updated generic bootstrap version number to 2.1.
+ 4) Submitted Richard's bootstrap test files.
+ 5) Removed MCORE stuff from generic bootstrap.
+ 6) Inversed order of "static" and "const" in _LIT()
+ definition to avoid lint warning.
+ 7) Added assabet.mbc (metabuild script).
+ 8) Implemented RProcess::GetMemoryInfo(). This allows to
+ extend GDB so it can attach itself to running threads.
+
+7) Michael
+ 1) Added overloaded function:
+ DTransferBuffer* TransferBufferFromHandle(TInt aHandle, DThread *aThread)
+ to \e32\include\k32std.h, exported and frozen for all BUILDS. Function
+ implemented in \e32\ekern\ks_transbuf.cpp. This function is used where the
+ current thread is not the same as the one that created the handle.
+ 2) Changed behaviour of DPlatTransferBuffer::~DPlatTransferBuffer() and
+ DPlatTransferBuffer::DoClose() in \e32\ekern\emul\win32\kp_transbuf.cpp and
+ \e32\ekern\epoc\kp_transbuf.cpp: iChunk gets only deleted if it actually exists,
+ i.e. is non-NULL
+ 3) Numerous changes to HWA implementation (User API, LDD and WINS PDD), work
+ still ongoing.
+
+Version 1.02.355
+================
+(Made by Nicolas, 04/05/2001)
+
+1) William
+ 1) Changed the WINC-only KernelStarted semaphore to be anonymous, to prevent
+ problems with concurrent WINC execution on a multiple processor build machine.
+ This will not re-open defect EDNGBON-4JYNU6 "Inaccessibility of request
+ semaphores breaks EPOC connect" because this isn't a request semaphore.
+ 2) Fixed TGlobalAlloc to use User::AllocL rather than new[], and User::Free instead of
+ the mismatched delete. This will now work even if new[] plays funny tricks (which
+ is the case with CodeWarrior) and makes the User::ReAllocL call legitimate.
+
+2) Nicolas
+ 1) Merged 6.1 release branch back into the mainline.
+
+Version 1.02.354
+================
+(Made by Dennis, 20/04/2001)
+
+1) AndrewJ
+ 1) Changed the misa kernel.iby file to detect whether the build is for
+ Assabet varient. If it is for assabet an alternative estart is
+ included in the rom which automatically loads the LFFS on to K: drive
+ as well as other tasks performed by estart. This should not take place
+ on any other platform.
+ 2) The generic estart is only loaded (in f32) for non Assabet platform as
+ added a definition call CUSTOM_ROM that is only defined for assabet.
+ 3) Added estart.cpp /assabetb/ and loadlffs.cpp to /assabetb/lffs/ for
+ new estart.exe component loaded only fopr Assabet.
+ 4) removed /test/ subdirectory in /assabetb/lffs/ as nothing it it is or
+ should be used.
+ 5) removed obsolete definition of BASE_ROM from F32tests.oby,
+ E32tests.Oby and Alltests.oby
+
+2) Morgan
+ 1) Deleted \e32\bmarm\EXYIN.DEF
+ 2) Added EPenState attribute to HAL to get/set state of the digitiser.
+ 3) Added EKeyboardState.
+ 4) Added pen/display get/set functionality to BRUTUS HAL DLL and driver.
+ 5) Added Enable() and Disable() functions to digitiser driver on Brutus.
+ 6) Tweeked Brutus digitiser driver to send switch on events when coming
+ out of standby or hibernation (disabled) mode.
+ 7) Removed LCD switch on from LCD power handler.
+ 8) Generic kernel now doesn't call DisplayOn().
+ 9) Added Power::SwitchOn() that can be called from device drivers to
+ send a ESwitchOn event if the KPowerUserCpu bit is not set. Does the
+ same thing as a call to SetRequirement(KPowerUserCpu | ...) but is
+ easier to understand.
+ Added variant that takes a TRawEvent to specify which event is sent
+ for switch on.
+ Call Power::SwitchOn() from your device driver to cause full UI switch
+ on.
+ 10) Tidied Brutus HAL DLL startup code.
+ 11) Made text window server take responsibility for turning on the screen
+ at switch on.
+ 12) Tidied Assabet HAL DLL startup code and removed spurious panicking
+ code.
+ 13) Updated HAL\DOC\HAL.DOC boilerplate startup code.
+ 14) Made display on imply switch on, and send events as appropriate
+ 15) assabetb, cirrus7211a, series5mx1 variant updates to maintain current
+ behaviour.
+ 16) Changed the prototype of DPowerModel::PowerStandby() to return an error
+ value.
+
+3) Dennis
+ 1) Fixed a problem with creation of fixed address chunks with initial
+ size zero.
+
+4) Jonathan
+ 1) Removed redundant Hal and UserHal functions from kernel and ASSPs.
+ 2) Refroze kernel exports for all platforms other than WINS/WINC.
+ 3) Removed associated variant functions and, where necessary to implement
+ the HAL API, re-implemented them via a HAL driver on the mainstream
+ platforms Brutus, Assabet and VTemplate. Other variant DLLs still
+ contain some redundant functions and may not have implementations for
+ all appropriate HAL attributes.
+
+5) Carlos
+ 1) Several changes to Assabet Variant to get PC Card working
+ 2) Assabet builds its own ATA driver (vi_medata.cpp). The generic ATA
+ driver is not used. Changed the MISA kernel.iby to allow Brutus to use
+ the generic ATA driver and Assabet to use its Variant-specific one.
+
+6) Dennis
+ 1) Added integrator port. No screen or serial drivers yet.
+
+7) Pete
+ 4) Fixed SCE-4V7S6C "MMC Controller card init. function is in-efficient
+ and unnecessarily complex". This entailed:-
+
+ - Add new TMmcCardArray class to replace the DMMCStack::iCxNewAcqArray[]
+ and DMMCStack::iCards[] arrays and their associated functionality.
+ - Removal of ASSP layer function DMMCStack::PhysicalCardSlots()
+ function as this was duplicating information already returned in the
+ ASSP layer function DMMCController::SetMachineInfo() function.
+ - Addition of generic layer DMMCStack::Init() function to determine
+ the max. number of cards for the platform once - at Controller
+ init. time rather than every time a card stack is initialized.
+ - Modification to DMMCStack::PowerDownStack() function to add an extra
+ argument to this function (TBool aMediaChange) indicating whether
+ the power down is required due to media change or not.
+ - Removal of the 'update stack' implementation in the generic layer of
+ the Controller. This was intended to re-scan for new cards after a
+ media change. This is now redundant since all cards are always
+ powered down on media change.
+ - Various comments added throughout PS_MMC.CPP to aid clarity.
+ 5) Fixed FID-4UZLFG "Increase number of supported local drives"
+
+8) Nicolas
+ 1) Added \brutusa\brutusa.mbc
+ 2) Cogent: Moved call to ImpHal::EnableIrqs() from ImpPic::Init3() to
+ beginning of ImpHal::Init3() to avoid the board hanging forever while
+ initialising the PCI base module.
+
+9) William
+ 1) Removed temporary WINSCW workaround in up_i64.cpp, now that the CodeWarrior
+ compiler supports the BT instruction.
+ 2) Added WINSCW-specific variation of the path constants in up_path.cpp
+ 3) Rearranged win32/up_trp.cpp version of TTrap::Trap() so that the register
+ saving happens before the C++ code to manipulate iResult and aResult. This
+ avoids a problem where the CodeWarrior compiler was saving EBX on the stack and
+ and using it as a temporary during the iResult/aResult mangling, causing the
+ wrong EBX value to be restored during Leave.
+
+Version 1.02.353
+================
+(Made by RobertJ, 26/03/2001)
+
+1) Carlos
+ 1) Several Changes in Assabet Bootstrap and vi_power.cpp in order to get
+ the Power Management/Sleep Mode working properly.
+ 2) Changes to Assabet Keyboard driver/controller
+ 3) Removed #define __USE_LEDS_FOR_SYSTEM_DEBUG. User software can now use
+ those LEDs if they wish.
+ 4) Had to implement a function in the Assabet Variant to allow enabling
+ RTC Interrupts. Surprisingly the SA1100 ASSP does not have these
+ functions!
+ 5) Some changes to the SA1100 Interrupt controller (only affect Assabet
+ as they were changes in the way External Interrupts are handled).
+ 6) Needed to export the Kernel function ImpMmu::LinearToPhysical as this
+ will be called from the Assabet Variant (vi_power.cpp).
+ 7) Got rid of the debug message printed every time the Variant is called:
+ after waking up, a call to re-enable the Debug Port would attempt to
+ print this out and crash!
+
+2) Alastair
+ 1) Added initial transfer buffer functionality. Chief classes are
+ RTransferBuffer and RTransferWindow user-side, described in
+ E32TransBuf.h, and DTransferBuffer and DTransferWindow
+ kernel-side, described in K32Std.h. Test program is built from
+ e32test\mmu\t_transbuf.cpp, though the test isn't fully
+ complete yet. Also, the scheme doesn't yet cater for transfer
+ buffer access via transfer windows for "fixed" processes, though
+ it will shortly.
+
+3) Nicolas
+ 1) Introduced example metabuild script for MCGA (see
+ \cogent1\cogent1.mbc).
+
+4) MarkCa
+ 1) Fixed CAN-4TXKZQ (Using a PC Card can wrongly produce password
+ notifier)
+ 2) Fixed CAN-4TWM6E (L7200 MMC Controller takes control of second UART)
+ Fix affects t_atadrv, so changed \l7200a\va_hw.cpp to use non-zero
+ machine uid.
+ 3) Fixed CAN-4TYFHS (Reading to the end of a MultiMediaCard can produce
+ an out-of-range error)
+ 4) Fixed EDNTDAS-4L4JZ8 (Thread leakage using emulators)
+ 5) Fixed TOD-4RXJSS (Race condition causing accessing of already delete
+ pointer when deleting DChannelComm)
+ 6) Fixed CAN-4UBJU2 (Controller does not process all error conditions)
+ 7) Changed l7200\pa_mmc.cpp to return KMMCErrNotSupported because pre 2.1
+ controller.
+ 8) Added __MLNK__ case to cpu defines in u32std.h.
+ 9) Fixed CAN-4UNE8D (MMC Controller access violation after emergency power
+ down)
+ 10) Removed KPBUS1 | KPBUS2 | KPBUSDRV tracing from mlnk\header.iby.
+
+5) AndrewJ
+ 1) Enabled LFFS on assabet.
+ 2) Edited vi_hw.cpp and vi_pbus.cpp to enable LFFS on K: with PC Card
+ disabled.
+ 3) put in fixes from 6.1 Numbers: SCE-4TVQ78
+ TOD-4RWEHL
+
+6) Dennis
+ 1) Fixed XScale RTC rounding problem
+ 2) Added check for imprecise aborts on XScale - fault the kernel if they
+ occur.
+ 3) iExtraData=FSR for both data and prefetch aborts.
+
+ *** Release note for XScale delivery ***
+
+ This release supports the Intel IQ80310 evaluation board based on the
+ XScale 80200 processor (Coyanosa). Code for this board can be built by
+ specifying platform MCOY on the build command line.
+
+ The following property definitions are used to specify the CPU type (in
+ \e32\include\u32std.h):
+
+ __CPU_XSCALE__
+ Means that the CPU is based on the XScale microarchitecture
+ __CPU_ARMV5TE
+ Means that the CPU supports the ARMv5TE instruction set
+ __CPU_ARM_ABORT_MODEL_RESTORED
+ Means that the base register is unaltered if a load/store with base
+ register writeback is aborted.
+ __CPU_SPLIT_CACHE
+ Means that the CPU uses separate instruction and data caches
+ __CPU_SPLIT_TLB
+ Means that the CPU uses separate instruction and data TLBs
+ __CPU_WRITE_BUFFER
+ Means that the CPU uses a write buffer
+ __CPU_WRITE_BACK_CACHE
+ Means that the CPU (data) cache supports write-back operation and that
+ the OS uses this mode for normal RAM allocations.
+ __CPU_CACHE_WRITE_ALLOCATE
+ Means that the CPU (data) cache supports line allocation on writes and
+ that the OS uses this mode for normal RAM allocations.
+ __CPU_CACHE_FLUSH_BY_LINE_ALLOC
+ Means that the (data) cache is cleaned/flushed by using an explicit
+ line allocate instruction.
+ __CPU_CACHE_POLICY_IN_PTE
+ Means that the (data) cache policy can be changed between writethrough
+ and writeback on a page-by-page basis using flags in the page table
+ entries.
+ __CPU_HAS_CACHE_TYPE_REGISTER
+ Means that the CPU possesses the cache type register as specified in
+ the ARM architecture reference manual (CP15 CRn=CRm=0, opc2=1)
+ __CPU_HAS_SINGLE_ENTRY_ITLB_FLUSH
+ Means that the CPU supports the 'Flush single ITLB entry by MVA'
+ instruction (MCR P15, 0, Rn, C8, C5, 1)
+ __CPU_HAS_SINGLE_ENTRY_ICACHE_FLUSH
+ Means that the CPU supports the 'Flush single ICache line by MVA'
+ instruction (MCR P15, 0, Rn, C7, C5, 1)
+ __CPU_HAS_BTB
+ Means that the CPU has a branch target buffer which needs to be
+ flushed explicitly in conjunction with partial ICache flushes.
+ __CPU_USE_MMU_TEX_FIELD
+ Means that the CPU supports the extended page table permissions (TEX)
+ field.
+ __CPU_EXC_VECTORS_MOVABLE
+ Means that the CPU allows the exception vectors to be relocated to
+ FFFF0000.
+
+ All E32 and F32 automatic tests pass on this release, with the exception
+ of:
+ T_PCCD1, T_PCCD2 - because the board does not support PCMCIA
+ T_DEBUGGER - because the debugger uses a bit pattern for breakpoints
+ which is defined in ARM Arch 5 (was undefined on ARM Arch 4). This
+ is being handled as a defect (defect number MAY-4V4E5V).
+
+ The branch target buffer is not enabled by this release. This is due to a
+ known problem when executing THUMB code with the BTB enabled.
+
+7) Pete
+ 1) First release of Hardware Accelerator (HWA) LDD and a crude emulation
+ of a HWA PDD on WINS.
+ 2) Changes to MMC Controller to support SD Memory card initialisation.
+ 3) Added TMMCCardArray class and various other minor changes to the MMC
+ Controller such (e.g. more comments).
+ 4) Improved the WINS MMC emulation. Two cards are now emulated rather
+ than one as before. Also, better account of the current card status is
+ taken when deciding how to respond to an MMC command.
+ 5) Change to the WINS local drive mapping. Local drive 2
+ is now the primary partition on the second emulated MMC card rather
+ than a secondry partition on the first emulated MMC card.
+ 6) Temporarily disabled PC Card Peripheral bus (EPBUS.DLL) on Cirrus Logic
+ board and replaced this with MMC Peripheral bus to facilitate development
+ of SD Memory card development. (PC Card support will be restored once
+ the multiple peripheral bus Controllers are supported).
+
+8) William
+ 1) Added exported destructor to CAsyncCallBack, to solve a problem with
+ the CodeWarrior compiler.
+
+Version 1.02.352
+================
+(Made by Morgan, 08/03/2001)
+
+0) Requires E32TOOLS(173), E32TOOLP(226), F32(260)
+ from \\epoc\development\base\ongoing\...
+
+1) Morgan
+ 1) Split functions in UP_DLL.CPP into separate source files. This
+ allows the linker to discard unused functions.
+ Functions are grouped by functional area. up_dll_file.cpp,
+ up_dll_global.cpp, up_dll_static, up_dll_tls.cpp.
+ 2) Split EDLL.LIB into EDLL.LIB containing the entrypoint and
+ EDLLSTUB.LIB containing the class Dll stub functions.
+ 3) Removed strange .idata$3 padding from UP_DLL.CPP since (we think) it
+ is a hack for a defunct version of GCC
+ 4) Moved thumb gcc helper functions into up_gcc.cpp in EGCC.LIB
+ 5) Removed thumb gcc helper functions from uc_exe.cpp. These are now in
+ EGCC.LIB that should be included in the link of a GCC EXE or GCC DLL.
+ 6) Moved float gcc helper functions into up_gcc_float.cpp in EGCC.LIB
+ 7) Removed null definition of atexit() from up_dll.cpp
+ 8) Deleted \e32\euser\epoc\arm\uc_dll.cpp since it is not used anywhere
+ 9) Integrated MAWD DDebugger bug fix (again)
+ 10) Added default cpu definition for __MTEMPLATE__ in U32STD.H to make it
+ compile
+
+2) Carlos
+ 1) Disabled the Pc Card on Assabet as it is not fully working and causes
+ problems when using the CF loader to download an image.
+
+3) Dennis
+ 1) Added basic port to Intel XScale 80200 CPU on IQ80310 board.
+ 2) Fixed defect HAS-4U7N92 (T_WWINS hangs on Brutus). This is due to the
+ smaller screen size compared with the Series 5.
+ Modified notifier stuff to take account of the screen size.
+
+4) RobertJ
+ 1) Added notification of clear stall to USB Client
+ 2) Fixed dma handling code for USB Client.
+
+5) Alastair
+ 1) Added initial transfer buffer functionality. Chief classes are
+ RTransferBuffer and RTransferWindow user-side, described in
+ E32TransBuf.h, and DTransferBuffer and DTransferWindow
+ kernel-side, described in K32Std.h. Test program is built from
+ e32test\mmu\t_transbuf.cpp, though the test isn't fully
+ complete yet. Also, the scheme doesn't yet cater for transfer
+ buffer access via transfer windows for "fixed" processes, though
+ it will shortly.
+
+6) Nicolas
+ 1) Introduced example metabuild script for MCGA (see
+ \cogent1\cogent1.mbc).
+
+7) MarkCa
+ 1) Fixed CAN-4TXKZQ (Using a PC Card can wrongly produce password notifier)
+ 2) Fixed CAN-4TWM6E (L7200 MMC Controller takes control of second UART)
+ Fix affects t_atadrv, so changed \l7200a\va_hw.cpp to use non-zero
+ machine uid.
+ 3) Fixed CAN-4TYFHS (Reading to the end of a MultiMediaCard can produce an
+ out-of-range error)
+ 4) Fixed EDNTDAS-4L4JZ8 (Thread leakage using emulators)
+ 5) Fixed TOD-4RXJSS (Race condition causing accessing of already delete
+ pointer when deleting DChannelComm)
+ 6) Fixed CAN-4UBJU2 (Controller does not process all error conditions)
+ 7) Changed l7200\pa_mmc.cpp to return KMMCErrNotSupported because pre 2.1
+ controller.
+ 8) Added __MLNK__ case to cpu defines in u32std.h.
+ 9) Fixed CAN-4UNE8D (MMC Controller access vilation after emergency power
+ down)
+ 10) Removed KPBUS1 | KPBUS2 | KPBUSDRV tracing from mlnk\header.iby.
+
+Version 1.02.351
+================
+(Made by Carlos, 20/02/2001)
+
+1) Carlos
+ 1) Added Assabet Variant (\Assabetb). This is an interim release
+ (see Release_Notes.txt)
+ 2) Debug Monitor on SA1100 ASSP: now gets the serial port number to
+ be used as debug port from the variant TInt Variant::DebugInit().
+ 3) Interrupt Controller on SA1100 ASSP: expanded the Interrupt controller
+ to work with Conceptual Interrupts (IRQ11-27) and external interrupts.
+ Also disabled the watchdog to free-up the OST Timer3 as an auxillary
+ timed interrupt source for LFFS.
+ 4) Several changes to Brutus' Variant according to what's decribed above.
+ 5) FIR Driver: Assabet allows setting the IR range. Therefore a new
+ Synchronous Request was introduced to deal with this.
+ 6) ecomm driver - as above, passes the setting for the range on
+ iSIRSettings member of the Config structure.
+ 7) Implemented EARLY DEBUG on SA1100 ASSP.
+ 8) A few changes on the SA1100 ASSP implementation of PC Card Controller.
+ 9) SA1100 Text shell: changed Background/foreground colours to improve
+ visibility on Assabet.
+ 10) Text Shell (generic): now traps EKeyIncBrightness and
+ EKeyDecBrightness.
+ 11) HAL: added Machine ID for Assabet on hal_data.h.
+ 12) HAL: changed hal.iby file to include an HAL##VARIANT##.DLL to get
+ round the problem of having two Variants coming off the same ASSP but
+ not sharing the same HAL. Changed the hal.mmp on \assabetb, \brutus,
+ \cirrus721, \cogent1, \l7200, \series5mx1 and \vtemplate.
+ NOTE: Had to change \romkit\base.iby to allow overnight builds to
+ build correctly.
+ 13) MISA EKERN def file (e32\bmisa\ekernu.def) - includes a new export
+ Plat::BindExtInterrupt(..) to allow binding to external interrupts
+ on Assabet.
+ 14) Some changes on MISA .IBY files. LFFS is excluded for the time being,
+ even on Brutus. It will be put back when Assabet's LFFS is ready. The
+ bootstrap is now passed with the Variant extension to its name. Now
+ includes a Hal LDD in kernel.iby.
+ 15) MISA Variants allowed (\e32\rombuild\rom.cfg): now allows 3 variants,
+ Brutus (BA), Assabet-only (A0) and Assabet+Companion Card (AB).
+
+2) MarkCa
+ 1) UART media change must now be explicitly compiled in for linkup
+ MMC port.
+ 2) t_atadrv will now not run media change tests on linkup. Machine
+ UID modified in va_hw.cpp to avoid clash with Cogent.
+
+3) William
+ 1) Introduce __CW32__ defines for CodeWarrior, and adjust various
+ compiler-related definitions accordingly.
+ 2) Workaround bugs in the CW inline assembler
+ 3) Remove spurious WINBASEAPI decorations in euniw.h, which upset
+ CodeWarrior.
+
+4) RobertJ
+ 1) Fixed problem with FIR reads in D_FIR.CPP, the LDD. When read
+ completes to LDD from the PDD it was possible for another read to
+ complete the same user request.
+ 2) Added first release of USB client for SA-1100. Components are
+ EUSBC.LDD, which is a generic LDD, and EUSBCC.DLL. \EUSBCC is the USB
+ Client Controller and loads as a KERNEL extension.
+
+Version 1.02.350
+================
+(Made by Dennis, 05/02/2001)
+
+1) William
+ 1) Adjust the x86 inline assember in euser\emul\win32 so that it is
+ acceptable to the CodeWarrior compiler: change the 8000h style
+ constants to 0x8000, and change "_asm SomeLabel:" into "SomeLabel:".
+
+2) Dennis
+ 1) Added APIs to support execution of data as code, for use by just in
+ time compilers for Java and also for the ARM JBit extension. New APIs
+ are:
+
+ TInt RChunk::CreateLocalCode(TInt aSize, TInt aMaxSize, TOwnerType);
+
+ This creates a data chunk with a globally unique virtual address which
+ is allocated from the top of virtual address space (as for EXE and DLL
+ code chunks). The chunk is accessible only by the current process
+ (unlike DLL code chunks) and is marked by the kernel as containing
+ code. This means that on a split-TLB machine the ITLB will be flushed
+ when a reschedule occurs to or from a process with a chunk of this
+ type mapped into it and also when pages are decommitted from such a
+ chunk. The globally unique virtual address means that the ICache need
+ not be flushed on a reschedule.
+
+ RHeap* UserHeap::ChunkHeap(RChunk& aChunk, TInt aMinLength, TInt aGrowBy=KMinHeapGrowBy);
+
+ This creates a heap in an already existing chunk. It is intended to
+ allow a heap to be created in a local code chunk; this heap can then
+ be used to hold code fragments from a JIT compiler.
+
+ void User::IMB_Range(TAny* aStart, TAny* aEnd);
+
+ This performs whatever cache cleaning/flushing operations are
+ necessary in order to guarantee correct execution of code in the
+ specified address range (from aStart inclusive to aEnd exclusive),
+ under the assumption that this code has been loaded/modified by user
+ code. Typically this will involve cleaning the data cache for the area
+ concerned, draining the write buffer and flushing the instruction
+ cache and branch target buffer for the area concerned.
+
+ 2) Added a new chunk type EUserSelfModCode to TChunkType to represent the
+ new chunks. Added a new attribute DPlatChunk::ECode to the DPlatChunk
+ iAttributes field to signify any chunk containing code.
+
+ 3) Added code to notify the ARM ETM of reschedules if the PROCID register
+ exists (conditioned on __CPU_HAS_ETM_PROCID_REG).
+
+ 4) Added support for kernel trace via the JTAG port on ARM720 and ARM920.
+ The KHARDWAREASSIST bit in the debug mask controls whether tracing is
+ directed to the JTAG port or to a UART.
+
+ 5) Modified perl script halcfg.pl so that the output file is not opened
+ until the inputs have been parsed - this prevents strange error
+ messages due to a zero length file being generated.
+
+
+Version 1.02.310
+================
+(Made by Morgan, 09/04/2001)
+
+1) Jonathan
+ 1) Move notes for releases prior to creation of 6.1 release branch to
+ releases_old.txt.
+
+2) Pete
+ 1) Fixed SCE-4V7S6C "MMC Controller card init. function is in-efficient and
+ unnecessarily complex". This entailed:-
+
+ - Add new TMmcCardArray class to replace the DMMCStack::iCxNewAcqArray[]
+ and DMMCStack::iCards[] arrays and their associated functionality.
+ - Removal of ASSP layer function DMMCStack::PhysicalCardSlots() function as
+ this was duplicating information already returned in the ASSP layer function
+ DMMCController::SetMachineInfo() function.
+ - Addition of generic layer DMMCStack::Init() function to determine the max.
+ number of cards for the platform once - at Controller init. time rather than
+ every time a card stack is initialized.
+ - Modification to DMMCStack::PowerDownStack() function to add an extra
+ argument to this function (TBool aMediaChange) indicating whether the power
+ down is required due to media change or not.
+ - Removal of the 'update stack' implementation in the generic layer of the
+ Controller. This was intended to re-scan for new cards after a media change.
+ This is now redundant since all cards are always powered down on media
+ change.
+ - Various comments added throughout PS_MMC.CPP to aid clarity.
+ 2) Fixed FID-4UZLFG "Increase number of supported local drives"
+
+
+Version 1.02.309
+================
+(Made by Will Ramsay, 03/04/2001)
+
+1) Requires E32TOOLP(226), F32(237)
+ from \\epoc\development\base\ongoing\...
+
+2) Backported Morgan's 6.2 changes to remove import stubs:
+ 1) Split functions in UP_DLL.CPP into separate source files. This
+ allows the linker to discard unused functions.
+ Functions are grouped by functional area. up_dll_file.cpp,
+ up_dll_global.cpp, up_dll_static, up_dll_tls.cpp.
+ 2) Split EDLL.LIB into EDLL.LIB containing the entrypoint and
+ EDLLSTUB.LIB containing the class Dll stub functions.
+ 3) Removed strange .idata$3 padding from UP_DLL.CPP since (we think) it
+ is a hack for a defunct version of GCC
+ 4) Moved thumb gcc helper functions into up_gcc.cpp in EGCC.LIB
+ 5) Removed thumb gcc helper functions from uc_exe.cpp. These are now in
+ EGCC.LIB that should be included in the link of a GCC EXE or GCC DLL.
+ 6) Moved float gcc helper functions into up_gcc_float.cpp in EGCC.LIB
+ 7) Removed null definition of atexit() from up_dll.cpp
+
+
+Version 1.02.308
+================
+(Made by MarkCa, 20/03/2001)
+
+1) Morgan/AndrewF
+ 1) Fixed FOD-4TAH7A "DMA double buffering will not work on Halla".
+ This is an interface change and it is not source compatable.
+ Added extra buffer fill during transfer initialisation for double
+ buffered HW. Added explicitly named enums and new imp functions
+ in ASSP to make writing ImpDMA easier.
+ 2) Changed all ASSPs, and added implementation details to template
+ port.
+ Detail of changes required to \e32\ekern\epoc\arm\<assp>\KA_DMA.CPP:
+ a) Remove ImpDma::NextBlock()
+ b) Add the following functions:
+
+ /**
+ * No more DMA blocks for this transfer
+ *
+ * TO DO: (mandatory)
+ *
+ * Modify to suit your hardware. The code below is just an example
+ *
+ * If your DMA hardware has multiple buffers this function should be
+ * used to disable the empty buffer
+ */
+ void ImpDma::FinalBlock(TInt aChannel);
+
+ /**
+ * Get the reason for the DMA interrupt.
+ * Called from TDmaInterrupt::Service()
+ *
+ * TO DO: (mandatory)
+ *
+ * Modify to suit your hardware. The code below is just an example
+ *
+ * EBufferEmpty indicates that one buffer is empty
+ * EStall indicates the entire transfer is complete, ie both buffers
+ * empty, FinalBlock() has been called.
+ * EError indicates a transfer error
+ * (ELastBuffer indicates that one buffer is empty and FinalBlock()
+ * has been called. On most hardware it is sufficient to return
+ * EBufferEmpty in this case)
+ *
+ */
+ Dma::TDmaState ImpDma::GetState(TInt aChannel);
+
+ //
+ // Return ESingleBuffer or EDoubleBuffer
+ //
+ Dma::TDmaBufferMode ImpDma::BufferMode();
+
+
+2) Nicolas
+ 1) Fixed STE-4UEQC2 "The case off event and possibly some other events
+ do not get through WSERV correctly". EPOC doesn't any more send
+ two ESwitchOn notifications instead of one when starting up. The
+ emulator now sends only one ESwitchOn notification when being
+ switched back on after an emergency power off. The emulator sends
+ ECaseOpen or ECaseClose notifications when F11 is pressed while not
+ in standby mode. And finally the emulator doesn't any more switch
+ off automatically when the case is closed (this is up to the
+ user-side event consumer).
+ 2) Fixed STE-4UJPEC "Some of the HAL attributes are not supported".
+ The following attributes are now supported on WINS: EPenDisplayOn,
+ ECaseSwitch, ECaseSwitchDisplayOn, ECaseSwitchDisplayOff.
+ 3) T_NEWHAL TestGetAll() output modified to make it readable on a
+ small screen (key press expected when screen is full).
+3) MarkCa
+ 1) Fixed CAN-4UNE8D (MMC Controller access vilation after emergency power
+ down)
+ 2) Removed KPBUS1 | KPBUS2 | KPBUSDRV tracing from mlnk\header.iby.
+
+
+Version 1.02.307
+================
+(Made by Nicolas, 27/02/2001)
+
+1) Jonathan
+ Manual e32test cleanup:
+ 1) Moved T_COLOUR from a manual to a support test since no-one bothers
+ implementing text video modes other than mono. Made those screen
+ drivers that didn't already return KErrNone from SetMode(EMono).
+ 2) Moved T_PS and T_WWINS from manual to support tests since they're not
+ useful.
+ 3) Nuked T_PTNOS test and D_PTNOS test driver.
+ 4) Nuked T_REGRAM registry test (which was lurking unused since v6.0).
+ 5) Made T_INF prompt for confirmation that displayed values are OK, so
+ if not OK an error appears in the test log.
+ 6) Fixed FID-4TXFVX "Wrong defaults for MainBatteryGood()".
+ 7) Fixed FID-4TYF78 "FIQ link with battery state is broken".
+ 8) Fixed BAR-4SMG99 "Efficiently implement the "MergeModifiers" function
+ in e32\include\K32KEYS.INL".
+ 9) Fixed FID-4RRMTH "bootstrap: Bug searching for sleep info block".
+
+2) MarkCa
+ 1) Fixed CAN-4TXKZQ (Using a PC Card can wrongly produce password
+ notifier)
+ 2) Fixed CAN-4TWM6E (L7200 MMC Controller takes control of second UART)
+ Fix affects t_atadrv, so changed \l7200a\va_hw.cpp to use non-zero
+ machine uid.
+ 3) Fixed CAN-4TYFHS (Reading to the end of a MultiMediaCard can produce
+ an out-of-range error)
+ 4) Fixed EDNTDAS-4L4JZ8 (Thread leakage using emulators)
+ 5) Fixed TOD-4RXJSS (Race condition causing accessing of already delete
+ pointer when deleting DChannelComm)
+ 6) Fixed CAN-4UBJU2 (Controller does not process all error conditions)
+
+3) Dennis
+ 1) Fixed defect HAS-4U7N92 (T_WWINS hangs on Brutus). This is due to the
+ smaller screen size compared with the Series 5.
+ Modified notifier stuff to take account of the screen size.
+ 2) Fixed defect HAD-4T2EJ5 (P::TimerLockSpecToTicks returns incorrect
+ value).
+ 3) Fixed defect MAT-4TYKLE (Profiler doesn't work on Quartz/Brutus).
+
+
+Version 1.02.306
+================
+(Made by Markdo, 07/02/2001)
+
+1) Tim Band
+ 1) Fixed BAD-4SVJY8 "Unavoidable initialisation cost for TRect, TPoint
+ and TSize"
+
+2) Alastair
+ 1) Fixed EDNTBAD-4Q8M2F "CBufSeg can leak memory"
+ 2) Fixed EDNATHE-4QQJSU
+ "Inconsistent error handling in use of S::MakeHandleAndOpen",
+ though there's still some work to be done in this area.
+ 3) Fixed FID-4RKDJT
+ "Use Cogent key translation tables on template port"
+ 4) Fixed HAD-4RLFVN
+ "Template header.iby has exyin.dll as file instead of extension"
+ 5) Fixed HAD-4RLFSY
+ "Template header.iby missing kerneltrace entry"
+ 6) Fixed FID-4SNDAD
+ "TemplatePort: Tick counter not invalidated when time changed"
+
+3) Morgan
+ 1) Integrated fix for DPassiveDebugger allocation bug for
+ WINDERMERE
+
+4) Jonathan
+ 1) Created new \e32\ekern\emul\win32\d_entry.cpp as a copy of
+ \e32\euser\emul\win32\up_dll.cpp. This allows edev.lib to be built
+ for WINS in an IPR Category E only build. To preserve layering WINS
+ device driver initialisation no longer wires the kernel.
+ 2) Documented the deprecated nature of UserHAL enums in e32hal.h.
+ Added minimal documentation to \hal\inc\hal.h and hal_data.h.
+
+5) MarkCa
+ 1) Update linked build by removing warnings from linkup ekern and
+ implemented polling after MMC data transfers.
+
+Version 1.02.304
+================
+(Made by Pete, 19/01/2001)
+
+1) Morgan
+ 1) Fixed EDNSCHM-4M7PAJ. Added RMessagePtr::IsNull()
+ 2) Fixed EDNJPAR-4KLLCA "Brutus bootstrap contains large delay..."
+ 3) Fixed EDNRFID-4NVFWF "Bootstrap test-code has Brutus-specific code"
+ 4) Fixed EDNRFID-4MVEQV "Bootstrap: bug in RAM width checking"
+ 5) Fixed EDNRFID-4MVKBL "Bootstrap attempts to write to ROM"
+ 6) Fixed EDNRFID-4NXETX "Bootstrap: bugs mapping IO as sections"
+ 7) Fixed EDNWROS-4LQEPN "bootstrap component -WHAT output incorrect"
+ 8) Fixed EDNRFID-4LGBVH "Bootstrap should keep PE file"
+ 9) Fixed EDNRFID-4PXFYK "Add buffered, not cached flag to bootstrap"
+ 10) Fixed EDNRFID-4PTHXH "Flush D TLBs & Cache in bootstrap after enabling
+ MMU"
+ 11) Fixed EDNRFID-4MVJZQ "Bootstrap bugs finding initial scratch RAM"
+ Tested on COGENT, BRUTUS, [UDEB,UREL]
+ 12) Fixed HEY-4STFK7 "Template port: Definition of interrupt names
+ should..."
+ 13) Fixed TOD-4RJJ75 "Corruption of K::TickQ". This fix creates a change
+ in the behaviour of the emulator - comms power handler active requests
+ keep the power requirement up. In practice this means that the
+ emulator will never power off. A proper fix will have to wait for v7.
+
+2) Pete
+ 1) Fixed a problem introduced in release 303 with the
+ Cirrus bootstrap which was mapping in 16K rather than 12K for the h/w
+ registers.
+ 2) Changes to the MMC Controller - to the way that the
+ ASSP layer reports the operating PSU voltage. Removed TOCR class.
+
+3) Dennis
+ 1) Modified low-memory notification system. There are now two TChanges
+ flags: EChangesFreeMemory and EChangesOutOfMemory. The first is raised
+ if the free memory level crosses the relevant threshold, and the
+ second is raised if an allocation fails due to insufficient free
+ memory.
+
+4) Jonathan
+ 1) Brutus HAL: Fixed defect EDNABOT-4MCGNL "HALData::EKeyboardClickVolume
+ doesn't accept valid value". Key click and digitiser click are not
+ supported on Brutus for 6.1. Changed the values reported by HAL to
+ reflect this. Cogent was similarly incorrect.
+ 2) Added memory traces for kernel stack and data.
+ 3) Brutus keyboard: Fixed defect JAN-4RLLH3 "Brutus board doesn't map
+ EKeyDevice key codes". Made Fn modifier generate EKeyDevice0-9. Fixed
+ some Fn and Shift translation errors.
+
+5) Markdo
+ 1) Implemented Pc Card Controller for Cogent. Controller is disabled (by
+ setting total supported drives to 1) until timer problem sorted out.
+ 2) Fixed problem in Brutus Pc Card Controller where reset signal not
+ asserted for long enough when powering up. Reduced length of time spent
+ in Sa1100::BootWaitMilliSeconds when called in \brutus1\vi_pbus.cpp.
+ 3) Ensured that uart1 in linkup initialised in release builds.
+ 4) Implemented dma on linkup.
+
+6) MarkCa
+ 1) Merged in MMC security code. _LOCKABLE_MEDIA in e32svr.h is not
+ commented out any more.
+ 2) Updates to linkup example mmc port.
+
+
+Version 1.02.303
+================
+(Made by RobertJ, 13/12/2000)
+
+1) Nicolas
+ 1) ECOMMDCE: Cancel power handler timer and reset power requirements in
+ DChannelComm dtor (pasted from ECOMM). This avoid a kernel panics
+ in DPowerHandler::RemovePowerModel() when a DCE comm port is
+ closed.
+ 2) Added DISTRIBUTION.POLICY file (cat. E) to \e32\rombuild\mlnk and
+ removed superfluous ones from E32 and BOOTSTRAP.
+ 3) Modified rom.bat to avoid spurious error msg when some files
+ included in the ROM image contain "warning" or "error".
+
+2) Dennis
+ 1) Removed all MCORE code.
+ 2) Minor consolidation of MMU-related #ifdefs in order to support ARM920.
+ __CPU_SOFTWARE_CACHE_FLUSH, __CPU_CACHE_CONFIGURABLE have gone.
+ __CPU_ARMV3 is no longer supported.
+
+ Remaining #ifdefs with meanings are:
+
+ __CPU_CACHE_POLICY_IN_PTE
+ This means that you can select write through or write-back caching
+ on a page-by-page basis.
+ __CPU_WRITE_BACK_CACHE
+ This means that write-back caching is being used. This may be
+ either because the cache only supports write-back mode (eg SA1100)
+ or the cache supports both modes and write-back mode is being used
+ (eg ARM920). If this is not defined and the cache can support both
+ modes, write-through caching will be used.
+ __CPU_CACHE_FLUSH_BY_DATA_READ
+ This option is only applicable if write-back caching is in use.
+ It means that the cache must be flushed by reading spurious data
+ (i.e. SA1100 mode). Currently the data used for flushing is always
+ mapped at 0x430fe000 and a cache size of 8K is assumed. If this
+ option is not selected and write-back caching is in use, the
+ ARM920 method is used (ie flush each line by way/set index) and
+ the CP15 cache config register is read to determine the size and
+ layout of the cache.
+ __CPU_SPLIT_CACHE
+ This means that the processor has separate instruction and data
+ caches.
+ __CPU_SPLIT_TLB
+ This means that the processor has separate instruction and data
+ TLBs.
+
+ 3) Added low memory notification. This uses two thresholds (low and
+ good). If a low-level chunk adjust or allocation of page tables fails
+ due to out-of-memory or causes the amount of free memory to drop below
+ the low threshold, all change notifiers are signalled. If a low-level
+ chunk adjust or freeing of page tables causes the amount of free
+ memory to rise above the good threshold change notifiers are also
+ signalled. A new change notifier flag (EChangesFreeMemory) has been
+ added to signify the occurrence of one of these conditions. A new
+ function
+
+ TInt UserSvr::SetMemoryThresholds(TInt low, TInt good)
+
+ has been added to set the thresholds at which notification occurs.
+
+ Test program T_CHUNK has been extended to test this system.
+
+ 4) Fixed defect EDNATHE-4LCEWZ (Sessions using global message pool can
+ lose available slots).
+ 5) Fixed defect PAR-4R6DGK (WS_MAIN.CPP should have an extra line of debug
+ to warn you that you have booted in test mode).
+ 6) Fixed defect EDNJPAR-4L2LMM (WS_MAIN.CPP has a leave without a trap).
+ 7) Fixed defect EDNJPAR-4N9GU2 (TEiger:: missing from added 7211 functions
+ in ka_eiger.cpp)
+ 8) Fixed defect HAS-4R5NPC (JTAG trace example in template variant).
+
+3) Alastair
+ 1) Fixed EDNJHAS-4QLRPC "All 3rd UIDs wrong" (in the template port).
+ Uids are now the UNICODE rather than narrow values.
+ 2) Split this file up on the assumption that its large size is the
+ reason P4 sometimes has difficulty accepting changes to it.
+ Old release notes are now in release_old.txt.
+ 3) Fixed EDNJHAS-4QNRUB "Template variant include file in E32" by moving
+ it into the vtemplate directory and exporting it from there.
+ 4) Fixed EDNJHAS-4QNR4M "Template ASSP is in the wrong place"
+ 5) Changed include paths in VTemplate .mmp files so that they no longer
+ refer to \e32\include.
+ 6) Added DISTRIBUTION.POLICY files (cat. E) to the \VTemplate
+ directories.
+ 7) Fixed EDNABRY-4L8NR2 "Text console appears stripy on Windows 95"
+ 8) Fixed problem with emulator parent window appearing jazzed if no
+ bitmap is specified on Windows9x platforms.
+ 9) Fixed EDNJBRN-4MEP5F
+ "Threads that use a shared heap don't get their stack 0x29 filled".
+ 10) Fixed EDNATHE-4QQKZM
+ "RThread().Suspend() deadlocks the emulator".
+ Under WINS/WINC, if a thread is about to suspends itself then it
+ relinquishes the kernel critical first.
+ 11) Fixed EDNTEEA-4L4BHV
+ "WINS emulator does not remember its previous position".
+ Emulator only remembers its position if it's shutdown with Alt+F4 or
+ via the Windows menus, not with typing "exit" in eshell or exiting
+ from a test. It is clever about not "reappearing" off-screen.
+ 12) Extended Dennis' low memory notification changes to work under WINS.
+ 13) Fixed defect FID-4RDJTJ
+ "Template port keyboard driver generates streams of keyup"
+ 14) Fixed defect FID-4RHKC9
+ "Template Idle function should not be naked"
+ 15) Fixed defect EDNNGRE-4LGJU7
+ "UserHal::SwitchOff() hangs emulator if mouse is pressed".
+ Problem: Emulator would power off but not minimise since mouse button
+ was down, and power on requires impossible window restoration.
+ Solution: No longer minimise and maximise Emulator window to emulate
+ Power Off and Power On. Instead, blank screen for Power Off. Power
+ back on when EStdKeyOff (F9 by default) is pressed. Power on also if
+ screen is tapped, or case is opened (toggle F11 by default), depending
+ upon EPointerSwitchesOn and ECaseOpenSwitchesOn
+ HAL/machine_configuration settings: these values now default to TRUE
+ for WINS.
+
+4) MarkCa
+ 1) Fixed defect EDNJHET-4PTLUD (Emulator crashes on startup if com
+ ports used by another program under win98.)
+
+5) Pete
+ 1) Modified the FIR LDD so it conforms with latest power handling scheme
+ (i.e. it requests it's power requirement on all tx requests while at
+ the same time setting a timer to releases these requirements if it is
+ allowed to expire). This in turn required an extra function to be
+ added to each FIR PDD - PowerRequirement() which returns the FIR power
+ requirements for that particular platform.
+ 2) Fixed warnings when building WINS version of MMC Controller.
+ 3) Modified TBusLocalDrive class and the associated local media
+ sub-system so that an info. descriptor can be passed down to the media
+ driver which is available to the driver at the point at which it is
+ opened.
+ 4) Fixed warnings when building WINS version of MMC Media Driver.
+ 5) Applied various bug fixes supplied by Pete Sanders for Cirrus Logic
+ build:-
+ - Increased BDB IO block size from 8K to 16K in bootstrap.
+ - Moved addition of power handler from Variant::Init3() to
+ Variant::Init4().
+ - Set mem. config registers for both banks of 8Mb flash in
+ Variant::Init1().
+ - Fixed problem with digitizer resistive plate enable signals.
+
+6) Morgan
+ 1) Fixed EDNGTIN-4KUH3E "Dll::FileName inconsistent in ARMI",
+ Mini-loader now forms the filename correctly.
+ 2) Fixed memory allocation bug in DPassiveDebugger
+ 2.1) Fixed empty members of DProcess for bootstrapped processes,
+ (kernel and file server) for the benefit of the debugger
+ 3) Enabled DPassiveDebugger on Cogent UDEB builds
+ 4) EDNMHEY-4N3FV8 "TDma::iChannel should be set back to ENotBound ..."
+ 5) PAR-4R5EGK "Definition of interrupt name should be in ASSP header ..."
+ Moved interrupt name definitions from ka_pic.cpp to a32*.h
+ MCGA, MISA, MAWD, MLNK, MEIG
+ 6) Updated Cogent1, Brutusa, Series5mx1, l7200a, cirrus7211x, variants to
+ use symbolic interrupt names
+ 7) Updated \e32\rombuild\rom.cfg to match stricter options in ROMBUILD
+
+7) Jonathan
+ 1) Changed meaning of KMEMTRACE kernel trace option. Now only traces
+ changes in chunk committed size and does not trace RHeap allocation.
+
+8) Markdo
+ 1) Changed WINS simulated mmc drive to 1MB size (from 2MB).
+
+9) William
+ 1) Added iRomRootDirectoryList to TSuperPage in K32STD.H
+ 2) Added TExtensionRomHeader in E32ROM.H
+ 3) Modified epoc\kp_ini.cpp to get the iRomRootDirectoryList from the
+ superpage
+ 4) Changed bootstrap to pass the iRomRootDirectoryList address vai the
+ superpage, and added code to support extension ROMs. If a valid
+ extension ROM is found, the Root Directory List comes from the
+ extension rather than the main ROM.
+
+
+Version 1.02.302
+================
+(Made by Nicolas, 19/10/2000)
+
+1) Alastair
+ 1) Applied fix which will be made on the release branch to EDNJBON-4PBJFD
+ "Crystal emulator won't run under Windows 98"
+ 2) Replaced calls to Win32 "W" suffixed functions, which won't work on
+ Windows9x platforms, with new versions supplied in EUNIW.DLL.
+ 3) Merged in Template Port from //epoc/release/bpk/.... This builds as
+ platform MTemplate and the variant is described by the \VTemplate
+ directory. Function comments have been changed to JavaDoc format.
+ Changes have also been made in accordance with Jonathan's changes to
+ E32 version 301, detailed below ...
+ \e32\include\v32arm.h --> \e32\ekern\epoc\katemplate\v32template.h
+ \e32\include\v32templateassp.h --> \e32\ekern\epoc\katemplate\a32templateassp.h
+ \e32\include\v32templatev1.h --> \e32\ekern\epoc\katemplate\v32template1.h
+
+2) Nicolas
+ 1) Fixed defect EDNNTHY-4PMKJW "RDebug Breakpoints Are Sometimes
+ Ignored Under Brutus". The B bit is now set in
+ KRomSectionPermissions and KRomPtePermissions. As a side-effect,
+ on CPUs with write-through caches the write buffer is now used for
+ shadowed pages. On SA-1100, setting B ensures the main data cache
+ is used instead of the mini one, and so fixes the defect.
+
+3) Pete
+ 1) Added WINS platform layer for MMC Controller.
+ 2) Changed the WINS EPBUS.DLL from being a PC Card Controller
+ to being an MMC Controller (i.e emulation of the PC
+ Card Controller has now been disabled in WINS and replaced
+ with an MMC Controller emulator). Similarly, the Media Driver
+ for WINS drive X: is now a MMC Media driver rather than a CF card
+ Media Driver.
+ 3) Fixed defect EDNMCAN-4P5C37 "File Mgr:Memory card menu is
+ not dynamic'. Fixed by powering down any MMC cards while
+ the media door is open and not allowing any operations on
+ the cards during this time.
+ 4) Implemented inactivity timer on MMC Controller. While the
+ MMC bus is powered up, if a given period elapses (set at the
+ ASSP/Variant layer) where no MMC bus activity has taken place,
+ then the MMC clock is turned off and power removed from the
+ bus.
+
+4) Dennis
+ 1) Fixed defect EDNDFER-4N2K8R (Wrong error code returned by fix to
+ another bug). DThread::Read/Write now return KErrDied if the target
+ thread has exited.
+
+5) Jonathan
+ 1) Removed old distrib IPR files and script.
+
+
+Version 1.02.301
+================
+(Made by MarkCa, 29/09/2000)
+
+0) Must add the following line (BEFORE LINE 44) to
+ \\epoc\main\romkit\include\base.iby when releasing to mainline:
+ extension[VARID]=ASSP_DIR\BUILD_DIR\epower.dll System\Libs\EPower.dll
+
+1) Pete
+ 1) Merged in changes to MMC Controller from Cambridge base porting
+ branch.
+ 2) Improved scheme in MMC Controller on how information on
+ number of MMC sockets and media drives is returned.
+ This is now set in the variant layer as you would expect.
+ 3) Removed workaround for broken MCR instruction on ARM915T from
+ \E32\EKERN\EPOC\ARM\KC_MMU.CPP.
+ 4) Changes to Cogent DTE serial port drivers. Also to
+ Cogent IREQ1 interrupt control code. These changes,
+ together your Cogent board re-configured with config 'p120_05_v12'
+ and also a PCB cut/strap modification to each DTE serial port to
+ reverse the TX and RX signals will allow the Cogent DTE serial ports
+ to work fully.
+ Cogent EUART3.PDD which had been temporarily modified
+ to drive 'SERIAL 1' rather than 'SERIAL 2' (PCB designations) has now
+ been changed to drive 'SERIAL 2'.
+
+2) MarkCa
+ 2) Added linkup port from BPC. Build with assp MLNK, variant LA.
+
+3) Nicolas
+ 1) Fixed defect EDNNTHY-4P3GT6 (RDebug::SingleStep() does not stop
+ after one instruction sometimes). Fix applied to arm generic and
+ windermere.
+
+4) Jonathan
+ 1) Include file re-org for IPR reasons - ASSP-specific include files live
+ in the ASSP directory under ekern:
+ - Include files describing ASSPs (TEiger etc) are named a32*.h:
+ v32eiger.h -> ekern\epoc\arm\721x\a32eiger.h
+ v32s1100.h -> ekern\epoc\arm\sa1100\a32sa1100.h
+ v32wind.h -> ekern\epoc\arm\windermere\a32windermere.h
+ v32cog.h -> ekern\epoc\generic\cogent\a32cogent.h
+ - Custom interface files are named v32*.h:
+ v32arm.h -> ekern\epoc\arm\721x\v32eiger.h
+ v32arm.h -> ekern\epoc\arm\sa1100\v32sa1100.h
+ v32awd.h -> ekern\epoc\arm\windermere\v32windermere.h
+ v32arm.h -> ekern\epoc\generic\cogent\a32cogent.h
+ v32mcore.h -> ekern\epoc\generic\cogent\a32cogent.h
+ - All variant-specific include files moved to the variants.
+ - kc_std.h -> kc_arm.h.
+ 2) New exported file for the text notifier interface
+ \e32\include\twintnotifier.h split out from ws_std.h, which is no
+ longer exported.
+
+5) Morgan
+ 1) Integrated fix from 6.0 branch: Fixed EDNTRIN-4BPCTM2 "Detection of
+ pointer events stops - multiple platforms" for MAWD. Keyboard now
+ detects switch on keys while sleeping.
+ 2) Removed \brutus\v32isa.h and references
+ 3) Called through to the variant for the following functions on MISA
+ TBool ImpPsu::ExternalPowerPresent();
+ TSupplyStatus ImpPsu::MainBatteryStatus();
+ TInt ImpPsu::MainBatteryMilliVolts();
+ TSupplyStatus ImpPsu::BackupBatteryStatus();
+ TInt ImpPsu::BackupBatteryMilliVolts();
+ 4) Moved MISA, MCGA, MCGM, MEIG default power models to variant layer so
+ they can be replaced as necessary
+ 5) Removed P::SwitchOffBacklight(). Calls to this can be replaced with
+ Hal::SetBacklightOn(EFalse)
+ 6) Promoted P::OsSwitchOnScreen() to Plat:: so it can be called from the
+ power model.
+ 7) Added Plat::DebugInit() to force re-initialisation of the trace port
+ after switch off.
+ 8) Fixes to the interface and implementation of DDebugger/DPassiveDebugger
+
+6) Alastair
+ 1) Applied fixes already made on release branch for EDNABRY-4PHFJJ:
+ "Emulator support for international keyboards is broken on Windows9x
+ platforms" and EDNSRES-4P4EFD: "CopyAnyWhere page fault on Win 98".
+
+
+Version 1.02.300
+================
+(Made by Dennis, 13/09/2000)
+
+1) Alastair
+ 1) Renamed K32ADDR.H to M32ADDR.H and removed references to it from
+ WINS/WINC builds, since it isn't required.
+ 2) Fixed Base v6.1 defect EDNWROS-4MJKWH
+ "Request for a change to emulator window size calculation".
+ The Emulator window no longer defaults to the Series5 Fascia bitmap
+ size, and expands to accommodate the specified digitizer size if
+ necessary.
+
+2) William
+ 1) Modified COGENT1 MMP files to use \e32\bmarm DEF files in all cases
+ 2) Fixed a few places in RArrayBase where delete was being used on a
+ TAny* pointer. This should be User::Free() as there is no destructor
+ to be called.
+ 3) Fixed EDNMMIR-4JQDYY "E32DEF.H doesn't correctly use all the features
+ of GCC" by changing the definitions of CONST_CAST etc.
+ 4) Fixed EDNWROS-4MEJRS "_LIT generates compiler warnings when string
+ contains large Unicode constants" as suggested in the defect report.
+ 5) Replaced lots of M*Core PP:Fault(PP:ESystemException) calls with
+ distinct Mcore::Panic(Esomething) calls so that we can tell which is
+ which.
+ 6) Export \e32\bmarm\eloclu.def
+ 7) Remove excess ".." in bootstrap makefile variables BUILDDIR and
+ TARGETDIR
+
+3) Jonathan
+ 1) Changes to distrib mechanism:
+ - "mnt distrib generic" no longer includes source under \e32\euser
+ since this is "IPR Category D: Additional" source. Split out MMP
+ files under \e32\euser into new \e32\additional.inf file.
+ - New "mnt distrib Additional" is similar to "generic" but does
+ include the \e32\euser source.
+
+4) Dennis
+ 1) Merged in MCore source from Motorola.
+ 2) Added GCC helpers for 64-bit integers (long long) to EUSER so that the
+ same .DEF file can be used for ARM and MCore.
+ 3) Added test program SAVEHAL to HAL component to store the modifiable HAL
+ values in \System\Data\HAL.DAT
+
+6) Markdo
+ 1) Added support for pci interrupts on Cogent.
+
+
+Version 1.02.276
+================
+(Made by Morgan, 31/08/2000)
+
+1) Alastair
+ 1) Fixed defect EDNABRY-4NFNPX
+ "HAL component should create HAL.LIB from a dummy HAL.DLL project".
+ Now a dummy HAL.LIB can be created for ARMI, ARM4 or THUMB builds by
+ executing "abld build armi", or some similar command(s), for dependent
+ components to link to. The HAL.DLL created in the ARMI, ARM4 or THUMB
+ release directories is an empty implementation and should be ignored.
+
+2) Morgan
+ 1) Fixed defect EDNJBED-4NAFQ2 "Switch makes the digitiser freeze"
+ 1) Gave the LCD a power handler so it can respond to on/off calls
+ from the power model. (Effects MISA, MAWD)
+ 2) PowerStandby can now be aborted. Power handlers are given a
+ power-on call if they were sent power-off and standby is later
+ aborted. (Effects generic kernel)
+ 3) Changed the MISA digitiser wrt 2
+ 4) Improved the PM heuristics in the WINS and EPOC comms drivers to
+ guess when it is busy. (Effects WINS/EPOC comms)
+
+
+Version 1.02.275
+================
+(Made by Alastair, 24/08/2000)
+
+1) Alastair
+ 1) Fixed defect EDNPHAR-4N3HRA "Access Violation when closing RLibrary
+` handle".
+ Note that entrypoints of DLLs which are statically-linked
+ to, having already been dynamically-loaded, will not have their
+ entrypoints called in the statically-linked context.
+
+
+Version 1.02.274
+================
+(Made by MarkCa, 17/08/2000)
+
+1) Morgan
+ 1) Fixed EDNMHEY-4N3FAY. Removed references to V32ETNA.H from MEIG and
+ MAWD platforms.
+
+2) MarkCa
+ 1) Fixed EDNTBLT-4MFKKY (peripherals need to be started after extensions
+ loaded). The pbus code has been moved to P::InitialiseLocalDrives(),
+ which is called from InitialiseLocalDrivesL().
+
+
+Version 1.02.273
+================
+(Made by Alastair, 2/8/2000)
+
+1) Alastair
+ 1) Removed enum EKeyEuro from E32Keys.h - fixes EDNGASR-4MKLHW
+ "EKeyEuro should not be 0x80 but 0x20AC in e32keys.h"
+
+2) MarkCa
+ 1) Fixed defect EDNPSCE-4MFPQC Media Change doesn't work properly
+ on MMC Controller
+ \e32\drivers\medmmc\epoc\d_medmmc.cpp
+ Added return value checking for Engage() calls, particularly in
+ DMmcMediaDriverFlash::SessionEndDfc() where value is used to
+ determine behaviour on media door opening / closing.
+ \e32\epbus\epoc\linda\pa_mmc.cpp
+ Added KPBUS1 conditional door interrupt debug trace.
+ \e32\epbus\epoc\linda\pa_std.h
+ Made MediaState() definition in TLindaMMCMediaChange virtual. It
+ is implicitly virtual because it is derived from TMediaChangeBase.
+ \e32\include\p32mmc.h
+ Made TMediaState MediaState() pure virtual function in
+ TMMCMediaChange. The function is pure virtual from
+ TMediaChangeBase anyway. Added AccessMediaChange(TPBusNum aBus)
+ function to DMMCController. MediaChange(TPBusNum aBus) is
+ declared as a pure virtual protected function in
+ DPeriphBusController, and so is not accessible from
+ DMMCSession::Engage().
+ \e32\include\p32mmc.inl
+ Added definition for DMMCController::AccessMediaChange(TPBusNum
+ aBus). This is an accessor function that simply returns
+ MediaChange(aBus).
+ \e32\epbus\ps_mmc.cpp
+ Added checking to DMMCSession::Engage() to return KErrNotReady if
+ media driver tries to launch a write while the door for the
+ associated bus is opened.
+ \e32test\pccd\t_mmcdrv.cpp
+ Added test code to check above modifications. Source file must be
+ explicitly recompiled with TEST_DOOR_CLOSE #define set to non-zero
+ for test to work.
+
+3) Jonathan
+ 1) Disallow reads/writes to/from dead threads. Fixes EDNDFER-4MFNER.
+ 2) Also removed some old code from ks_thrd, commented out since ER1.
+
+4) Nicolas
+ 1) Fixed EDNNTHY-4MNJXK (Kernel crash after calling ARM4 code from
+ THUMB code).
+ In the exception reporting code in __ArmVectorUndef(), the address of
+ the invalid ARM opcode is now forced to a four-byte boundary before
+ fetching the opcode. Fixed both in kc_int.cpp (arm generic) and
+ ke_int.cpp (windermere).
+
+
+Version 1.02.272
+================
+(Made by RobertJ, 20/07/2000)
+
+1) Morgan
+ 1) Added a TVersion member to the Debugger API
+ 2) Added a iDebugger member to TKernelPage so it is available
+ to externel debugger software over JTAG/BDM, at a constant
+ address. Removed K::Debugger.
+ 3) Fixed EDNMMAT-4M6KHZ "TLex::Val returns the wrong number"
+
+2) Alastair
+ 1) Fixed EDNJBON-4MBMC8 '"set _epoc_drive_j=...." causing emulator
+ problems' by removing trailing spaces from _EPOC_DRIVE_? environment
+ variables as they are read.
+
+3) Dennis
+ 1) Fixed EDNKLIG-4LVJST (Device turns off when time changed).
+ The problem was due to K::TickCounter being updated when the system
+ time changed. This no longer happens - K::TickCounter now increments
+ every tick when the machine is on and does not change when the machine
+ is off. The offset between K::TickCounter and the real time clock is
+ remembered in order to make locked timers work.
+
+
+Version 1.02.271
+================
+(Made by Morgan, 5/07/2000)
+
+1) Morgan
+ 1) Fixed EDNBBOY-4LWGW2
+ 2) Fixed MCGA Monitor warnings
+ 3) Fixed Cirrus7211a MMP warnings
+
+
+Version 1.02.270
+================
+(Made by RobertJ, 29/06/2000)
+
+1) RobertJ
+ 1) Fixed EDNMHEY-4L3KX7 "References to Licensee hardware in generic code"
+ 2) Changed \e32\drivers\dfir\epoc\d_fir.cpp to return an error code for a
+ read failure
+ 3) Changed \e32\drivers\dfir\epoc\d_fir.cpp test for buffer full from
+ >= to > as limit excluded valid transfer address.
+ 4) Changed \e32\drivers\dfir\epoc\dmabuff.cpp error code was not always
+ correctly returned. It could return zero when in error
+ 5) Changed \brutusa\vi_fir.cpp to remove 1ms wait after write to
+ spin until TUR flag set (fifo is empty) then TBY flag transmitter busy.
+ This is to remove as much latency as possible in tx->rx turnaround
+
+2) Jonathan
+ 1) Fixed EDNJHAS-4LQPA5: changed MMAD to use ARM Base Restored Data
+ Abort Model.
+
+3) Pete
+ 1) Fixed EDNPSCE-4L3CHV "Device driver slow open
+ mechanism doesn't work properly on machines with more than one PCMCIA
+ slot."
+ In fact, the slow open mechanism is OK as long as a
+ separate unit number can be used to open a serial channel on each
+ slot. Hence, the change really just involves enabling the PC Card
+ Serial driver on Brutus to open on either PC Card slot.
+ Bottom slot - Unit number 3 (Com4).
+ Top slot - Unit number 4 (Com5).
+ Also a change to the function DPhysicalDevice::CheckForSlowOpening()
+ just to make this more logical.
+
+4) MarkCa
+ 1) Removed Kern::Printf() debug from DLindaMMCStack::DoPowerUpSM() in
+ \e32\epbus\epoc\linda\pa_mmc.cpp.
+
+Version 1.02.269
+================
+(Made by Dennis, 22/06/2000)
+
+1) Alastair
+ 1) Using CP_ACP rather that CP_UTF8 for EPOC.INI file text conversion
+ since CP_UTF8 is not supported on Windows 95
+ 2) Fixed EDNWROS-4L5NLW "Text window server has hardcoded width of 80
+ characters in some places" and EDNNGRE-4H2MKK "ConsoleBase does not
+ work on small screens" by replacing the hardcoded widths of 80
+ characters by iTextScreenSize.iWidth in
+ \e32\drivers\edisp\emul\win32\wd_wins.cpp.
+ 3) Fixed EDNNSIH-4LCLNE "Access violation when loading SMUM.DLL..." by
+ using the base name of a dll rather than it's full name to get a Win32
+ handle to it, in case it's already been loaded from a different
+ directory.
+ 4) Fixed EDNRCLF-4L4FB2 "User::LeaveIfError crash while trying to connect
+ to File Server Session in WINC" Now the dll reference table for the
+ starting process includes efile.dll and dependent dlls if efile.dll
+ has already been loaded by the process. This ensures that the
+ efile.dll's entry point is called on startup where necessary and that
+ the file server is started.
+ 5) Fixed EDNRCLF-4LALXK "E32Initialize Crash".
+ UpWins::__DllAttachProcess() now changes "TRUE" return value from
+ Win32 DLLs to KErrNone.
+
+
+2) Morgan
+ 1) EDNRFID-4FQKKQ Zero-filled the 'Visibility Map' in the text window
+ server, during initialisation.
+ 2) EDNMHEY-4L9NKJ Added TRawEvent::ECaseOpen and TRawEvent::ECaseClose
+ events
+ 3) Added idle off behaviour to the comms LDD D_COMM. This stops the
+ machine turning off while
+ a) there is a write request outstanding,
+ b) 20 seconds elapse after the last character has been sent,
+ c) there is a read request outstanding
+ 4) Altered comms PDD for all variants wrt above.
+
+3) Dennis
+ 1) Yet another 'fix' for defect EDNGBON-4JYNU6 (Inaccessibility of request
+ semaphores breaks EPOC connect). For WINC the semaphore name has been
+ reverted to be the same as ER5U.
+
+4) Pete
+ 1) Changes required to move Cirris Logic bootstrap over
+ to the new bootstrap scheme.
+
+
+Version 1.02.268
+================
+(Made by Markdo, 07/06/2000)
+
+1) Alastair
+ 1) Fixed EDNTJOS-4JGME4 "Dialog title EPOC32 fault needs to be changed"
+ 2) If dll entrypoints return TRUE, the return value is changed to
+ KErrNone.
+ This change means that Win32 DLLs linked to by EPOC DLLs can return
+ TRUE without resulting in a KErrBadLibraryEntryPoint error.
+
+2) Nicolas
+ 1) Fixed bugs preventing from building __EARLY_DEBUG__-enabled MCGA
+ kernels.
+
+3) Dennis
+ 1) Fixed EDNPPAN-4KEELX (HAL attribute for keyboard backlight needed).
+ 2) Fixed EDNPPAN-4KPEEL (HAL attribute EAccessoryPower needed).
+ 3) Fixed EDNJPAR-4KLLGL (HAL TManufacturer not generic).
+ 4) Fixed EDNRFID-4KTFD3 (Bootstrap doesn't clear first new page table).
+ 5) Removed ARM architecture 3 maths code from UC_I64.CPP and UC_REALX.CPP.
+ The architecture 4 code is always used now.
+
+Version 1.02.267
+================
+(Made by Alastair, 23.5.2000)
+
+1) Dennis
+ 1) Fixed problem with all ARM bootstraps caused by switching mode from
+ svc26 to svc32 in a subroutine - LR will contain flags since the BL
+ was executed in 26-bit mode, giving an incorrect return address for
+ 32-bit mode. Fixed by masking top 6 bits of LR if the routine was
+ actually entered in 26-bit mode.
+ 2) Fixed defect EDNGBON-4JYNU6 (Inaccessibility of request semaphores
+ breaks EPOC connect). Thread request semaphores are no longer added
+ to the K::Semaphores container so that other EPOC code cannot access
+ them directly. On EPOC they are also unnamed, on Win32 they are named
+ PROCESSNAME::THREADNAME{EPOCTHREADID} so that the Win32 semaphore
+ inherits this name and can be found by EPOC connect.
+ 3) Fixed defect EDNSCHM-4K7MTC (CActiveScheduler::Error() broken on ARM).
+ 4) Fixed defect EDNDBAR-4K5EU3 (Close functions in RArray...)
+ 5) Fixed defect EDNMBOX-4JZEAP (TDblQueLink should allow multiple deques).
+ 6) Fixed defect EDNACLN-4JQK2F (HAL::Get panics on low memory).
+ 7) Fixed defect EDNSCHM-4JHRRS (RTimer::Inactivity only useful for switch
+ off)
+
+2) Nicolas
+ 1) Debug::EnableBreakPoint() now flushes instruction cache after writing
+ breakpoints into memory. This fixes the transient test failures
+ observed on brutus.
+
+3) Alastair
+ 1) Introduced new scheme into WINS/WINC so that Dll entry-points are
+ called by EPOC in much the same way that they are called on a target
+ device.
+ When a process is started or when a library is loaded, the Kernel
+ creates a Dll reference table for the executable to mimic the Dll
+ information available on the target device. EPOC under WINS/WINC can
+ thus call Dll entry-points at the appropriate times. This change
+ means that the Win32 Dll entrypoint mechanism is no longer used for
+ calling Dll entry-points, and therefore avoids deadlock occurring due
+ to the "hidden" critical section used by Windows operating systems
+ while making entry-point calls. This change fixes Symbian defect
+ EDNATHE-4GAL54 -
+ "Emulator hangs during startup"
+ Whether this change will also fix similar deadlocks occuring with the
+ Emulator running with NT SP5 on Compaq PCs remains to be seen.
+ 2) Added WINS/WINC base address for HAL.DLL - 0x6b000000
+
+4) Morgan
+ 1) Undid a change to TMillisecondTimer::CounterExpired that was causing
+ the digitiser to crash on Series5mx.
+
+
+Version 1.02.266
+================
+(Made by MarkCa, 16/05/00)
+
+1) Pete
+ 1) Fixed EDNPHAR-4JCNSC (Can't access removable drives
+ on latetst Brutus Roms).
+ 2) Fixed a couple of problems to allow UserSvr::ForceRemountMedia()
+ to work when a non-removable drive is specified. This now
+ allows the media driver for a non-removable drive to be swapped
+ successfully.
+ 3) Modified the ISR for the Brutus PCMCIA/CF Card Serial driver (COM4)
+ so that it now handles all pending UART interrupts in
+ a single call rather than just the highest priority interrupt. This
+ fixes problems with the driver where it could 'lose track' of
+ interrupts when multiple interrupts were pending.
+ This fixes EDNACLE-4JZL3V (Brutus PCMCIA Serial I/O Adapter hangs...)
+ and EDNPREF-4JCKV (Protocol hanging on Brutus board).
+ 4) Modified the Brutus PCMCIA/CF Card Serial driver (COM4)
+ to support change notification.
+ 5) Fixed a problem with Brutus built-in serial ports
+ (COM1 and COM2) which were not correctly configuring the port when
+ either Odd or Even parity was selected.
+
+2) RobertJ
+ 1) Fixed \brutusa\vi_com2.cpp, \brutusa\vi_fir.cpp, \brutusa\v32isaba.h
+ to cope with transceiver SIR/FIR mode change
+
+3) Morgan
+ Fixed some anomalies in the power handling code:
+ 1) Removed ImpHal::Standby() and ImpHal::Standby(aWakeup) (from
+ MAWD, MISA, MCGA, MEIG, MMAD)
+ and replaced it with appropriate code in the power model.
+ The correct way to turn off the machine from kernel-side is to call
+ a) DPowerModel::PowerStandby() for immediate kernel-side switchoff
+ b) Kern::AddEvent(ESwitchOff) for ordered user shutdown
+ To turn off from user side, we call UserHal::SwitchOff().
+ 1.2)Renamed K::SwitchOff() to Power::SwitchOff()
+ Renamed K::PowerOn() to Power::PowerOn()
+ Removed DPowerModel::PowerStandby(aWakeup) because it is useless.
+ 2) UserHal::SwitchOff calls Power::SwitchOff which calls PowerStandby on
+ all power handlers. This will cause
+ DPowerModel::PowerTransition(EPowerNone) to be called (when each power
+ hander has called SetRequirement(0)). The power model should then
+ call DPowerModel::PowerStandby() to turn the machine off. (see a)
+ above).
+ 3) DPowerModel::PowerStandby() works out when the next alarm is due, and
+ turns off the machine by calling the appropriate
+ DPowerModel::DoPowerStandby(/*aWakeup*/) function.
+ 4) Added a User-Cpu-In-Use flag to the power model's power-requirement.
+ This stops the machine turning off while there is user-side processing
+ but no device drivers (power handlers) active. This flag does NOT
+ prevent idle. This flag is unset when UserHal::SwitchOff is called,
+ and set for PowerOn.
+
+Version 1.02.265
+================
+(Made by Morgan, 18/4/2000)
+
+0) Must change \\epoc\main\generic\romkit\include\base.iby line
+ file[VARID]=ASSP_DIR\BUILD_DIR\cVARLETTERxyVARIANT.dll System\Libs\Exyin.dll
+ to
+ extension[VARID]=ASSP_DIR\BUILD_DIR\cVARLETTERxyVARIANT.dll System\Libs\Exyin.dll
+ when integrating to mainline.
+
+1) Morgan
+ 1) Made all XYInputs into kernel-extensions
+ 2) Removed TXYInput from M32HAL.H
+
+2) Dennis
+ 1) Fixed EDNJPAR-4G5FA8 (missing chunk types)
+ 2) Fixed EDNMBOX-4DSJXH (missing #include guards on e32des8.h
+ and e32des16.h)
+ 3) Fixed EDNJBON-4DCEHD (Kern::Printf doesn't support %c)
+ 4) Fixed EDNPBAA-4HXEST (TDes::Format doesn't support %i)
+ 5) Fixed EFNATHE-4GYFQ8 (Thread semaphores named after thread)
+ 6) Fixed EDNJHAS-4HCQAF (SA1100 standby)
+ 7) Fixed EDNDBAR-4C5E7V (RArray<> should have a TArray interface).
+ 8) Fixed EDNJHAS-4HXEGT (Literal length as compiler constant).
+ 9) Fixed EDNJHAS-4HXELS (Compile-time TFixedArray).
+ 10) Fixed EDNJHAS-4HXEPN (Support for profiling).
+ 11) Added CleanupStack checking functions:
+ CleanupStack::Pop(TAny* aExpectedItem) check top item and pop
+ CleanupStack::PopAndDestroy(TAny* aExpectedItem) check top
+ item, pop and destroy
+ CleanupStack::Pop(TInt aCount, TAny* aExpectedItem) Pop aCount
+ items, checking last one
+ CleanupStack::PopAndDestroy(TInt aCount, TAny* aExpectedItem)
+ Pop/destroy aCount items, checking last one
+ 12) Removed compiler warnings from E32 and variants.
+ 13) Added EMemoryRAMFree option to HAL to get amount of free RAM.
+ 14) Fixed EDNCDUG-4J3QA8 (collate.h includes files not in \epoc32\include).
+
+3) Alastair
+ 1) Fixed EDNABRY-4JGJG4 "Test T_Float fails under WINS/WINC"
+
+
+Version 1.02.264
+================
+(Made by Morgan, 7/4/2000)
+
+1) Morgan
+ 1) Added DPowerHandler::DoPowerTransition(aPowerState) virtual
+ function to the power handlers. Power handlers should
+ implement this if they need notification when the power state
+ of the machine changes.
+ 2) Added DPowerModel::PowerTransition to call the power handlers.
+ Added pure virtual function DPowerModel::DoPowerTransition()
+ to replace the DPowerModel::SetPowerState function, (which has
+ now been killed).
+ 3) Added Power Model locking - Power::[Un]LockPowerModel(). This
+ prevents the power model from shifting power states during
+ power critical periods.
+ 4) Added ECaseState to the HAL.
+ 5) Removed ImpHal::EmergencyStandby() from all platforms. This fn
+ is not used or needed any more.
+
+2) Nicolas
+ 1) Improvements and bug fixes in RDebug API implementation
+ so in-target-debugging will be usable on ER6 devices.
+ USER-LEVEL VISIBLE CHANGES:
+ * Debugging resources owned by the debugger and the
+ debuggee are automatically released when the
+ debugger/debuggee ends (this includes automatically
+ closing the debugging session).
+ * SDebugInfo has a new field containing the start
+ address of the debuggee's data/bss chunk: this is
+ mandatory to support the current toolchain in
+ gdbstub.
+ * THUMB breakpoints supported. Let A be the address
+ of a breakpoint to be set/cleared. In THUMB mode, A
+ should be passed as-is to RDebug. In ARM mode, A+2
+ should be passed. See below for a rationale.
+ * New class TArmBreakPoint added in kc_std.h. It
+ contains breakpoint characteristics and an inline
+ function that can be used to insert a hardcoded ARM
+ or THUMB breakpoint in user code.
+ INTERNAL CHANGES:
+ * Breakpoint notification in __ArmVectorUndef() was
+ disabled. It is now re-enabled. Code updated to
+ take into account both THUMB and ARM.
+ * Support for ARM BX instruction has been added to
+ single-stepping code. THUMB single-stepping still
+ not supported.
+ * In Debug::Continue(), removed code which stepped
+ over breakpoints located at the start address
+ because GDB already does the same thing. Removed
+ too, code which stepped over hardcoded breakpoints
+ because it was buggy and hardcoded breakpoints are
+ uncommon.
+ * New scheme used for breakpoints: a single 16-bit
+ opcode is used for both ARM and THUMB breakpoint.
+ For ARM, this pattern must replace the upper 16-bits
+ of the instruction to break at. As little-endian is
+ used, the breakpoint bit pattern is actually at
+ address+2, hence the API change described above.
+ * CPU-dependent modifications done in both generic ARM
+ and in windermere.
+ 2) Fixed defect EDNNTHY-4H6PXT (PC address computed at
+ start of __ArmVectorUndef() is wrong in THUMB mode).
+
+3) AndrewB
+ 1) Removed K32SND.H, K32SND.INL, D32SND.H and D32SND.INL
+ from the export section of bld.inf. These files should
+ no longer be public since all sound functionality is now
+ managed by the Media Server.
+
+4) MarkCa
+ 1) \E32\EPBUS\EMUL\WIN32\PP_PCCD.CPP
+ Added ReadPasswordFromStore() and EncodePassword().
+ Added logic to RPlatPccdChunk::(Read|Write) to automatically unlock
+ card if pw in store Replaced assertion w. return code in
+ DPlatPcCardController::WritePasswordData(). Added comments to describe
+ how emulated mechanism corresponds with real MMC mechanism.
+ Modified password store to use 128-bit card ids to simulate mmc better.
+ DPlatPcCardController::PasswordControl(),
+ DPlatPcCardController::PasswordStoreLengthInBytes(),
+ DPlatPcCardController::(Read|Write)PasswordStore()
+ All modified to give same behaviour as default DPeriphBusController
+ virtual functions if _LOCKABLE_MEDIA is not #defined.
+ 2) \E32\EPBUS\EMUL\WIN32\PP_STD.H
+ DPlatPcCardController prototypes for above.
+ Removed panics EWinsPcCard(MappingNotInStore|PswdStoreBadWriteDesc).
+ 3) \E32\INCLUDE\E32SVR.H
+ Added "//#define _LOCKABLE_MEDIA" so WINS PC Card controller can be
+ built without locking mechanism.
+
+5) Morgan
+ 1) Changed declaration of Custom::DriveSettings to pure virtual on
+ MAWD and MMAD and MIEG platforms.
+ 2) k32snd.h and d32snd.h are no longer exported, so:
+ Changed \series5mx\va_sdrv.h to get k32snd.* and d32snd.*
+ from \e32\include. Changed \cirrus72x1\va_sdrv.h to get k32snd.*
+ and d32snd.* from \e32\include. Modified k32snd.h and d32snd.h
+ to get header files from \e32\include
+
+6) Alastair
+ 1) Removed unused __USE_CRITICAL_SECTION__ #defines from the WINS/WINC
+ kernel.
+ 2) Removed badly-spelt LedArrangeVerticaly keyword from the EPOC.INI file
+ processing code - use LedArrangeVertically instead.
+ 3) Named the WINS/WINC kernel critical section mutex so that it can be
+ shared between processes.
+ 4) Fixed Symbian ER5u defect EDNHLOO-4HGKKJ
+ "EXPORT_C used instead of IMPORT_C in header file".
+
+7) Pete
+ 1) Added extra member to TDriveInfoV1 class:-
+ TInt iRuggedFileSystem
+ With this set (to KRuggedFileSystem), it indicates to the
+ file server that it should implement a rugged file system.
+ This required the addition of a new variant function - DriveSettings()
+ so the ruggedization option can be selected at the variant level.
+ 2) Added latest versions of LFFS Media drivers for WINS and Brutus - 4th
+ candidate version (R1.2) of LFFS.
+ 3) Modification to E32 local media subsystem so that the reading
+ of partition information from the media driver on mounting
+ a drive is done asynchronously. This affects the media driver API as
+ follows:-
+
+ TInt DMediaDriver::PartitionInfo(TPartitionInfo &anInfo);
+ becomes
+ void DMediaDriver::ReadPartitionInfo(TInt &aResult,const TCallBack& aCallBack);
+
+ The ReadPartitionInfo() call just initiates the reading of partitiion
+ information with this typically being concluded on an interrupt. From
+ the interrupt, the driver signals the conclusion of the requests by
+ call 'aCallback', having first written the result of the request to
+ 'aResult'. The partition info is now written by the driver directly
+ into its member data - DMediadriver::iPartitionInfo rather than being
+ passed back to the local media subsystem.
+
+8) Dennis
+ 1) Renamed iCount member of CObjectIx to iHighWaterMark. Added new member
+ iNumEntries which counts the number of actual entries in the index.
+ The Count() member function now returns iHighWaterMark so its meaning
+ is unchanged. Added new ActiveCount() member function to return the
+ new iNumEntries member.
+ Changed Exec::HandleCount() to return the number of actual handles open
+ rather than the high water mark of the handles array as before.
+
+Version 1.02.263
+================
+(Made by MarkDo, 30.03.2000)
+
+1) Morgan
+ 1) Reorganised the super-page into TSuperPage, TKernelPage,
+ and TMachineConfiguration. TMachineConfiguration has
+ been promoted from WINS.
+ TSuperPage holds values discovered by the bootstrap that
+ are required by the generic kernel. TKernelPage
+ contains generic kernel data that needs to be preserved
+ over a warm reset. TMachineConfiguration contains
+ system wide settings that should be persisted over a
+ warm reset and machine state saves (backup).
+ 2) Changed P::SetMachineConfiguration() and
+ P::MachineConfiguration() to use the new
+ TMachineConfiguration on all platforms.
+ 3) Removed iDebugger from the super page
+ 4) Fixed some warnings
+ 5) Changed the bootstraps for MEIG and MAWD to match new
+ superpage layout.
+ Changed bootstrap\include\superpage.h to match new
+ bootstrap.
+ 6) Removed PowerRestart functions since the power model
+ never calls them.
+
+
+Version 1.02.262
+================
+(Made by Dennis, 23.03.2000)
+
+1) Alastair
+ 1) Added calls to Sleep(0) before all occurrences of SetEvent(),
+ ReleaseSemaphore() and ReleaseMutex() in accordance with advice given
+ in MSDN Knowledge Base article Q173260. This change should make one
+ variant of the Emulator Hanging bug less likely to occur.
+
+2) MarkCa
+ 1) \E32\EPBUS\EMUL\WIN32\PP_PCCD
+ Added ReadPasswordFromStore() and EncodePassword().
+ Added logic to RPlatPccdChunk::(Read|Write) to automatically unlock
+ card if pw in store.
+ \E32\EPBUS\EMUL\WIN32\PP_STD.H
+ DPlatPcCardController prototypes for above.
+
+3) MarkDo
+ 1) Added additional media attributes KMediaAttLockable and
+ KMediaAttLocked.
+
+4) Pete
+ 1) Removed the EUSER class UserPcCardCntrl.
+ 2) Modified the function MBusDev::DoAsyncLateOpen() to
+ now take an additional second parameter 'TInt anOpenInfo'.
+
+5) Dennis
+ 1) Removed the EPOC registry - files US_REG.CPP, UB_REG.CPP and KP_REG.CPP
+ along with TRegistryCategory, TRegistryItemName, TRegistryItemValue,
+ CRegistry, CPersistentRegistry and Environment classes.
+ 2) Removed most UserHal:: functions - these have been superseded by HAL::
+ functions.
+ 3) Removed RThread::Create() overload taking a RProcess& parameter and
+ removed RProcess* parameter from the overload taking an RLibrary*
+ parameter. Threads may now only be created in the current process.
+ 4) Reassigned ARM domains following demise of registry. 2 is still used
+ for page tables, 3 is now used for the RAM drive and 4 for F32.
+ 5) Change to Brutus bootstrap to link at 0xc8000000 for compatibility
+ with 12Mb bootloader.
+
+
+Version 1.02.261
+================
+(Made by Robert, 17.3.2000)
+
+1) Morgan
+ 1) Added User::ResetInactivityTime() to reset all
+ RTimer::Inactivity timers
+ 2) Added TRawEvent::EKeyRepeat for adding auto repeated key events
+ to the event queue
+
+2) Pete
+ 1) Added kernel functions to read, write and return the
+ size of the Peripheral Bus Controller password store.
+
+3) MarkCa
+ 1) Added WINS PC Card locking features to test mmc (Crystal) functions
+
+ \E32\EKERN\KW_EXEC.CPP
+ Modified ExecHandler::Drive(ReadPasswordData|PasswordStoreLengthInBytes)()
+ to call P functions.
+
+ \E32\EKERN\KS_SVR.CPP
+ Modified svDriveWritePasswordData to call P::WritePeriphBusPasswordData().
+
+ \E32\EPBUS\EMUL\WIN32\PP_PCCD.CPP
+ Modified DPlatPcCardController::PasswordControl().
+ Implemented DPlatPcCardController::(Read|Write)PasswordStore(),
+ DPlatPcCardController::PasswordStoreLengthInBytes().
+ Read and write routines return KErrLocked if locked and accessing
+ EPccdAttribMem memory. This still allows chunks to be created for
+ locked cards.
+
+ \E32\EPBUS\EMUL\WIN32\PP_STD.H
+ Prototypes for above and store panic codes.
+
+4) RobertJ
+ 1) Entered suppilied mods to Linda SIR in vm_com2.cpp for all variants
+
+
+Version 1.02.260
+================
+(Made by Alastair, 10.3.2000)
+
+
+1) Alastair
+ 1) Updated e32 rombuild scripts to pick up the test .IBY files
+ generated by Bldmake from the new directory structure implied
+ by recent changes to E32TOOLP.
+
+ 2) Added temporary hack to bootstrap component extension makefile
+ so that mainline rombuilds for MEIG, MAWD and MMAD will still work,
+ now that the rombuild system has been changed to work with output
+ produced by the generic bootstrap build system.
+
+2) Pete
+ 1) Modified PC Card Controller emulator (EPBUS) in WINS
+ to implement Peripheral bus password functions (Lock/Unlock/Clear).
+ This is only possible on the simulated CF cards in Socket 0 (not the
+ simulated Compact rom card in socket 1).
+
+3) MarkCa
+ 1) \E32\EUSER\US_KSVR: converted
+ TBusLocalDrive::((Lock|Unlock)Drive)|ClearPassword) from async to sync.
+ \E32\E32SVR.H: changed TBusLocalDrive prototypes.
+
+Version 1.02.259
+=================
+(Made by MarkCa 03-03-00)
+
+1) Morgan
+ 1) Guarded POS hooks with #define __SUPPORT_PARTNER_OS__ and updated
+ U32STD.H appropriately. This removes partner OS support from most
+ platforms.
+ 2) 'Enhanced' the POS hooks. Kernel lock is now done after the POS
+ reschedule hook, instead of before. This makes it necessary to
+ check for the POS rescheduler being interrupted. If it has been
+ interrupted then we now make an early exit from the int-vector to
+ prevent running DFCs from the nested interrupt.
+
+2) William
+ 1) Fixed the borders for text-window server windows on EPOC devices.
+ WINS uses true Unicode fonts, but EPOC devices have a cp1252 font
+ built in, and so need to continue using the cp1252 encoding for the
+ box drawing characters.
+
+3) MarkCa
+ 1) Added TBusLocalDrive -> Exec -> ExecHandler functions for MMC
+ password support.
+
+4) Pete
+ 1) Added PasswordControl() function to TLocDrv,DMediaDriver and
+ DPeriphBusController classes.
+
+Version 1.02.258
+================
+(Made by Pete 24/02/00)
+
+1) Alastair
+ 1) Updated a few .mmp files to hardcode .def file locations.
+
+2) Dennis
+ 1) Made TDesC8::Left(), TDesC8::Right(), TDesC16::Left() and
+ TDesC16::Right() truncate the requested length to Length() instead
+ of panicing.
+ 2) Export COLLATE.H to \Epoc32\Include instead of \Epoc32\Include\Kernel
+ since it contains public interfaces.
+ 3) Added DEBUG mode checking to ensure that heaps are not referenced by
+ DFCs. Before calling a DFC the current heap pointer is changed to
+ 0xC90FDAA2 and is restored when the DFC returns.
+
+3) Morgan
+ 1) Removed \hal\group. BLD.INF is now in \hal. Removed annoying
+ "Nothing to do" declarations. Updated all variant hals to match.
+
+4) Robert
+ 1) Added new export ClearIrError for Linda in ka_linda.cpp and v32linda.h
+
+5) Pete
+ 1) Signal change notification added to Cogent DTE serial drivers (COM3 &
+ COM4).
+ 2) Fixed problem with signal change notification on DTE
+ and DCE serial drivers where it was possible for a transition on a
+ modem status line to occasionally fail to trigger notification.
+ 3) Added CF Card Serial driver for Brutus (COM4) - not yet tested.
+
+
+Version 1.02.257
+================
+(Made by Dennis, 14-02-2000)
+
+1) Dennis
+ 1) Added HAL component.
+ 2) Removed calls to most UserHal functions except for those which are
+ always available from the kernel.
+ 3) Inlined ::operator new(TUint, TLeave) and
+ CBase::operator new(TUint, TLeave) to remove the need for the
+ TLeave parameter to be generated by the compiler.
+ 4) Kernel now always disables auto switch off by default.
+ 5) Added RTimer::Inactivity() and CTimer::Inactivity() functions to
+ support generic user inactivity timers.
+ 6) Added K::InactivityQ and TInactivityLink to the kernel to implement
+ generic user inactivity timers.
+ 7) Added User::InactivityTime() to return the time elapsed since the last
+ user event.
+
+2) Morgan
+ 1) Exported hal_int.h into the system\kernel include dir
+ 2) Made \hal\group\config.mke generic so it works for HALs in
+ \hal component and also works for HALs in \<variant>\hal.
+ Renamed <variant>.hda and <variant>.hcf to values.hda and
+ config.hcf.
+ 3) Added HALs to linda b,c,1 variants
+ 4) Updated Variant::DisplayOn for all linda variants.
+ Code from Sampsa - not tested locally.
+ 5) Fixed EPBUS build error in pa_std.h on MMAD platform
+ 6) Added kernel-extension loading to kernel init.
+ Kernel extensions are loaded just before the file-server.
+ Extensions can have writable static data but global constructors
+ are not called.
+ 8) Made keyboard drivers on all platforms into kernel-extensions.
+ 9) Removed TKeyboard.
+ 10) Fixed bug in TIdler::Idle(). There are now 64 ticks in a second.
+
+3) Jonathan
+ 1) Fixes to "mnt distrib" mechanism and dsitrib.txt files.
+ Made distrib.pl checking stricter: Checks for mising distrib.txt files
+ and for non-existent files listed in distrib.txt.
+
+4) Pete
+ 1) Re-enabled the ACD on MEIG.
+ 2) Enabled main battery voltage measurement on Cirrus 7211
+ board (which is simulated using a pot. on the board). Also reference
+ voltage measurement. Disabled backup battery measurement.
+ 3) Added digitizer driver for Cirrus 7211 board - using
+ ADC channels to measure screen position.
+ 4) Generally tidied up variant for Cirrus 7211 board.
+ 5) Modified MEIG bootsrap so it resets DRAM width to
+ 32bit. (Cirrus 7211 repro program sets it to 16bit).
+ 6) Temporarily re-assigned Cogent UART3.PDD to use
+ UARTB rather than UARTC since UARTC/UARTD still have h/w problems
+ with setting thier interrupt mask registers. This means Cogent now
+ has a single DCE and DTE serial port. The ports are now assigned:-
+
+ Driver Port Number Uart Port Type
+ ------ ----------- ---- ---------
+ EUART1 Serial 0 UART-A DCE
+ EUART2 Serial 2 UART-C Not working
+ EUART3 Serial 1 UART-B DTE
+ EUART4 Serial 3 UART-D Not working
+
+Version 1.02.256
+================
+(Made by Simon, 01-02-2000)
+
+1) Dennis
+ 1) Added aLength parameter to Dll::GlobalRead() to specify how much data
+ to read.
+ 2) Added UserSvr::HalGet() and UserSvr::HalSet().
+
+2) Pete
+ 1) Modified Linda MMC Controller to include calls on the
+ power model to reduce the clock frequency during MMC operation (and
+ restore to normal clock frequency afterwards).
+ 2) Corresponding changes to the Linda power model to support MMC clock
+ switching.
+ 3) Added various additional functions to TLinda class to
+ support power model clock switching.
+ 4) Added CF card modem serial PDD to MAWD - DATXB13
+
+3) Morgan
+ 1) Integrated Matt's changes for the LCD on the HPs
+
+4) Simon
+ 1) Restructured e32 source directory, and moved varients to new components
+
+
+Version 1.02.255
+================
+(Made by Dennis, 19th January 2000)
+
+1) Morgan
+ 1) Bug fix for WINS emulator-configuration on the command-line
+ (EDNATHE-4ETJPC)
+ 2) MMAD LC/LB/L1 clock moved to 52Mhz and changed LCD settings
+ 3) EXPORT_Ced some more functions (in ImpAsic) for use by ENOS
+ 4) Integrated changes from Nile to MMAD keyboard drivers
+ 5) Added TRUST changes to MMAD bootstrap
+ 6) Modification to the POS fiq vector to defer POS reschedule
+ when interrupted from irq or svc mode
+
+2) Dennis
+ 1) Removed X86 build
+ 2) Removed NoLongerSupported... functions from EUSER and EKERN
+ 3) Removed TReal96. Removed the implementations of Math:: functions which
+ use TReal96; only the TRealX implementations now remain. Rewrote some
+ code in UM_RTOD.CPP (real to text conversion) to use TRealX instead of
+ TReal96.
+ 4) Removed SObjectIxArray, SObjectConArray and SObjectConIxArray. These
+ data members are now part of CObjectIx, CObjectCon and CObjectConIx
+ respectively.
+ 5) Inlined CObjectCon::UniqueID() and CObjectCon::Count()
+ 6) Changes to descriptor code from Andrew Thoelke. Copy constructors are
+ no longer explicitly defined (compiler generated instead). A protected
+ empty destructor has been added to TDesC8 and TDesC16 to prevent the
+ passing of TDesC and TDes parameters by value, which would result in
+ object slicing. To cope with static descriptors, an empty atexit()
+ function has been added to UP_DLL, UP_EXE and KC_EXE for all platforms.
+ 7) Added machine coded 16-bit descriptor code for ARM (UC_DES16.CPP). This
+ is enabled by __DES16_MACHINE_CODED in U32STD.H.
+ 8) Inlined TCallBack functions.
+ 9) Removed TChar copy constructor. This means that TChar parameters passed
+ by value are now passed in registers by GCC. Modified machine coded
+ functions which take a TChar parameter to account for this.
+ 10) Removed TLex8 and TLex16 copy constructors.
+ 11) UserSvr::StaticCallList(), UserSvr::DynamicCallList() and
+ RLibrary::LibraryCallList() are no longer exported.
+ 12) RChunk::CreateDllStatic(), RChunk::ReserveAt() and all overloads of
+ RChunk::Read() and RChunk::Write() have been removed.
+ 13) Added inline functions for converting TProcessId and TThreadId to and
+ from TUint.
+ 14) Removed RThread::Mark(), RThread::SetMark(), RThread::NotifyIfDie(),
+ RThread::SetNotifyIfDie(), RThread::Busy() and RThread::SetBusy().
+ 15) Removed RProcess::Mark(), RProcess::SetMark() and RProcess::Busy().
+ 16) Removed User::Abort() and User::Dying().
+ 17) Inlined TRawEvent default constructor, TRawEvent::Type() and
+ TRawEvent::Ticks().
+ 18) Removed RLoader::LoadProcess and RLoader::LoadLibrary functions which
+ don't take a TUidType. RLoader::Version() and RLoader::LoadProcess()
+ are no longer exported.
+ 19) Changed CCaptureKeys to use RArray instead of CArrayFixFlat.
+ 20) Removed class RMmu.
+ 21) Removed CArrayFixA etc.
+ 22) Options %E, %F, %G in TDes::AppendFormatList() now convert a TRealX
+ instead of a TReal96.
+ 23) Fixed bug in chunk creation - between setting the domain and the
+ iOwningProcess, the SetNameL could leave. The chunk destructor would
+ then erroneously free the domain.
+
+3) Alastair
+ 1) Removed SROS, ARM3 and MARM targets from BLD.INF and GENERIC.INF.
+ 2) Fixed minor problem with DIFILB.MMP.
+ 3) Added support for specifying color depths Gray256 and Color64K in the
+ EPOC.INI file with the ColorDepth keyword. Changed the Emulator color
+ depths default to all supported color depths rather than just Gray2,
+ Gray4 and Gray16.
+ 4) Made processing of all EPOC.INI file keywords case-insensitive, and
+ extended maximum line length from 80 to 256 characters. EPOC.INI
+ syntax errors are now captured and displayed in a Message box before
+ causing the Emulator to exit. Text from the EPOC.INI file is
+ converted to UNICODE before processing.
+
+4) Mark
+ 1) Added KLindaUidValue and used to set iMachineUniqueId in superpage
+ for MMAD L1/LB/LC.
+
+5) Pete
+ 1) Merged in latest changes to MMC Controller and MMC Media driver.
+ The Controller now supports multiple block read/writes requests
+ and the Media driver makes use of the multiple block reads.
+ 2) Added support in TCogent for the 2nd Dual UART device (ST16C2552) and
+ also suppport for its associated interrupts (in KA_PIC.CPP).
+ 3) Added DCE serial drivers to Cogent - not yet fully functional. Also
+ re-organized cogent serial PDDs. These are now assigned as follows:-
+ Serial 0 - DCE using ST16C552 device (CTS/RTS).
+ Serial 1 - DCE using ST16C552 device (CTS/RTS).
+ Serial 2 - DTE using ST16C2552 device (RTS,DTR/CTS,DSR,RI).
+ Serial 3 - DTE using ST16C2552 device (RTS,DTR/CTS,DSR,RI).
+ 4) Removed TLocalDrive class from EUSER (use TBusLocalDrive instead).
+ 5) Changed TBusLocalDrive Read(), Write() Format() functions to use a
+ TInt64 rather than a TInt to specify position within the drive.
+ 6) Removed RLogicalChannel class from EUSER (use RBusLogicalChannel
+ instead).
+ 7) Removed RDevComm class from EUSER (use RBusDevComm instead).
+
+Version 1.02.254
+================
+(Made by Pete, 21st December 1999)
+
+1) Petteri
+ 1) Added extended serial port functionality as required by Linda. A new
+ pair of device drivers has been added to enable Linda to act as a DCE
+ device in addition to DTE. New notifications and capabilities have
+ been added.
+
+ Files changed:
+ Inc\D32comm.h Inc\D32comm.inl
+ Inc\K32comm.h Inc\K32comm.inl
+ Inc\K32std.h Inc\V32linda.h
+ Dcomm\D_comm.cpp Vmadlc\Vm_com1.cpp
+ Vmadlc\Vm_com2.cpp Vmadlb\Vm_com1.cpp
+ Vmadlb\Vm_com2.cpp Varmca\Va_com1.cpp
+ Varmca\Va_com2.cpp Varmcl\Va_com1.cpp
+ Varmcl\Va_com2.cpp Varmp2\Va_com1.cpp
+ Varmpb\Va_com1.cpp Varmpc\Va_com1.cpp
+ Varmpc\Va_com2.cpp Varmpd\Va_com1.cpp
+ Varmpd\Va_com2.cpp Varmpd\Va_com3.cpp
+ Vawdb1\Va_com1.cpp Vawdb1\Va_com2.cpp
+ Vcgac1\Va_com1.cpp Vcgac1\Va_com2.cpp
+ Visaba\Vi_com1.cpp Visaba\Vi_com2.cpp
+ Visaba\Vi_com3.cpp Vrosr1\Va_coms.cpp
+ Vx86pc\Vx_comm.cpp Dpwins\D_cdrv.cpp
+ Kamad\Ka_linda.cpp Bmmad\Ekernu.def
+ Group\Bld.inf Ksrc\Ks_chn.cpp
+
+ Files added:
+ Dcomm\D_commdce.cpp Vmadlc\Vm_com1dce.cpp
+ Group\Ecommdce.mmp Group\Dmtxlc1dce.mmp
+ Group\Dmtxlb1dce.mmp Vmadlb\Vm_com1dce.cpp
+
+2) Pete
+ Changes to the above DCE serial drivers and the new notification aspects
+ of the DTE serial drivers:-
+ 1) Added DCE serial driver for Linda L1 together with the corresponding
+ changes to the existing DTE serial drivers for Linda L1.
+ 2) Postponed various notification completion calls to a DFC. Also, now
+ uses DThread::Write() were appropriate to return completion
+ information to the client thread.
+ 3) Changed implementation of NotifyFlowControlChange() so this only
+ completes when a change to a h/w signal has actually changed the Tx
+ flow control status. Also, now XON/XOFF changes trigger this notifier
+ too.
+ 4) Slight change to the way NotifySignalChange() is implemented.
+ 5) Implemented notification changes to WINS serial driver.
+
+3) Pete
+ Converted MEIG build to the Cirrus Logic 7211 - a ARM Architecture V4
+ device. MEIG can now be built for ARM4, ARMI and THUMB and can no longer
+ be used on ARM 7110 (Eiger) platforms.
+ 1) Modifications to Varmca variant (i.e. Cirrus Logic 7211 evaluation
+ board:
+ - Alterations to reflect changed GPIO allocation for the Rev.B
+ evaluation board.
+ - Fixed problem with diagnostic LED.
+ 2) Fixed a problem with enabling additional CL-PS7111 interrupts.
+ 3) Fixed a problem with TEiger::SetUart2Config() so that the 2nd 7211
+ serial port now works OK.
+ 4) Altered MEIG bootstrap to use ARMv4 rather than ARMv3 coprocessor
+ instructions to flush the cache and TLB. Also, now maps an extra page
+ for the additional 7211 Eiger specific registers.
+ 5) Changed the definitions for MEIG in U32STD.H to use ARM4 rather than
+ ARM3 settings.
+ 6) Added added support for additional 7211 registers in the TEiger class.
+ 7) Modifed BLD.INF so that only the CA variant is built for MEIG
+ builds. The PB,PC,PD,P2,CL variants are no longer built.
+
+4) Pete
+ 1) Changes to e32\dcomm\d_comm.cpp to fix a s/w flow control
+ problem. If SetConfig() is called on the serial port with
+ KConfigSendXon set in config.iHandshake and the port h/w has not yet
+ been initialised then the driver attempts to send an XON char with the
+ h/w off. No XON char is transmitted and no subsequent data can be
+ transmitted.
+
+5) Morgan
+ 1) Bug fix for MMAD LB and LC variants
+
+Version 1.02.253
+================
+(Made by Morgan, 3/12/99)
+
+0) Use with F32(201)
+
+1) Dennis
+ 1) Use section mapped garbage area for SA1100 cache flushing. Main cache
+ flush area is at 0x43000000, mini cache at 0x43100000.
+ 2) Added new function Mmu::FlushUnmap() which is called when RAM is
+ unmapped. This function flushes a writeback DCache to ensure that no
+ modified lines remain which relate to the unmapped memory.
+ 3) Added new function Mmu::FlushCode() which is called after new code
+ is loaded into RAM - in DPlatProcess::Loaded and DPlatLibrary::Loaded.
+ This flushes the ICache on a split-cache machine.
+ 4) Reinstated machine coded CActiveScheduler::Start() and CServer::RunL()
+ after applying the RunError() modifications from last release.
+ 5) Added new define __CPU_EXC_VECTORS_MOVABLE in U32STD.H for
+ SA1100. This signifies that the processor offers a choice about the
+ virtual address used for the exception vector table. Changed SA1100
+ bootstrap to place the vectors at 0xFFFF0000 and changed Mmu::Init1()
+ to set the end of the home section to 0xFFF00000 on SA1100.
+ 6) Fixed scheduler bug which caused a null pointer dereference in the case
+ where TheCurrentVMProcess=NULL, i.e. during boot.
+ 7) Modified SA1100 bootstrap to output boot tracing to the same port as
+ kernel tracing. Added more boot tracing. Tracing can now be done after
+ the MMU is enabled, since the output char function checks the MMU
+ control register.
+ 8) Modified SA1100 bootstrap to set the correct RAM wait states when
+ running from RAM, since the bootloader sets pessimistic values.
+ 9) Modified SA1100 bootstrap to mark the exception vectors as cacheable
+ and as readable by all code and writeable by none.
+ 10) Removed __MCGA__ hacks from KCARM. We now use __CPU_ARMV3 define to
+ determine whether to use architecture 3 or 4 MMU instructions.
+ 11) EXE code chunks are now allocated at the top of virtual address space
+ in the same region as DLL code chunks. Also they don't move during a
+ reschedule. This means that split-cache machines need never flush the
+ ICache except following loading of new code to RAM.
+ 12) When sharing a DLL code chunk, copy entry point from the library whose
+ code chunk is being shared.
+ 13) Added "kerneltrace 0x80000000" to every HEADER.IBY file, so panics are
+ always traced in debug builds.
+
+2) Morgan
+ 1) Fixed a couple of warnings
+ 2) Removed the 256 character limit from process command lines
+ Added Exec::ProcessCommandLineLength
+ Added RProcess::CommandLineLength()
+ Added RProcess::CommandLine(TDes&)
+ Changed UserSvr::ProcessCreate to take an additional cl HBufC parameter
+ Changed svProcessCreate and S::ProcessCreate[L] accordingly, and added
+ cleanup code.
+ Changed RLoader::LoadProcess RMessage to take additional cl parameter
+ Changed WINS getFileNameAndCommandLine initialisation function
+ DProcess::Create now takes and additional command line HBufC
+ 3) Fixed PWM interface in TLinda
+ 4) Added EStdKeyApplication<n> enumerations
+ 5) Added KHARDWAREASSIST to the KTRACE #defines for switching on
+ hardware that can assist with kernel tracing
+ 6) Mapped in CBA on EStdKeyDevice0..EStdKeyDevice3 on MMAD LB and LC
+ variants
+ 7) Added hardware assist tracing to Variant::DebugOutput() on
+ MMAD platforms
+ 8) Changed the XYInputType on MMAD platforms to EXYInputDeltaMouse,
+ and MCGA to EXYInputMouse by implementing ImpHal::XYInputType()
+ 9) Integrated Matthew's new MMAD L1 variant
+ 10) Integrated Matthew's WINS changes for mapping application keys
+
+3) Simon
+ 1) Use Cogent extended PCI space if available
+
+Version 1.02.252
+================
+(Made by Simon 25-11-1999)
+
+1) Morgan
+ 1) Process create now correctly notifies the debugger of the new main
+ thread.
+ 2) VMADLB and VMADLC report correct physical screen dimensions.
+ 3) Updated the MMAD bootstrap to take new flash initialisation values
+ 4) Pushed DPassiveDebugger Rom-library-hunting into 3rd stage kernel
+ initialisation. This is to allow the kernel heap to grow as required.
+ Also, reorganised strings in the DPassiveDebugger tables to take up
+ less room.
+ 5) Added EVT100.MMP to build the vt100 display driver.
+
+2) Alastair
+ 1) Changed exception-handling for system threads under WINS/WINC so that
+ exceptions are passed on to the system debugger for handling rather
+ than producing the Plat 46 dialog.
+
+3) Andrew T
+ 1) Fixed regression defect EDNMDON-4DJK8E (from Defect tracking V3.0) as
+ suggested.
+ 2) Added a further check on the message slot handle in
+ Kern::MessageComplete to verify that it lies within the kernel heap,
+ prior to the validity check. This prevents bogus message handles from
+ causing a kernel exception and crashing the kernel.
+ 2a) Modified E32 t_svr test to test the new check.
+
+4) Andrew B
+ 1) Added virtual "RunError" function to CActive definition in E32BASE.H,
+ and modified CActive::Scheduler::Start() to use new CActive::RunError
+ function when RunL leaves. It is a source compatible but not binary
+ compatible change.
+ 2) Modified U32STD.H to prevent machine-coded versions of CServer::RunL()
+ and CActiveScheduler::Start() being used until the implementations are
+ updated to reflect the changes to the C++ versions.
+ 3) Fixed long-standing defect in CActive::Deque() which stopped active
+ objects being re-added to scheduler. Updated T_ACT.CPP to test
+ CActive::Deque() defect and new RunError function.
+
+Version 1.02.251
+================
+(Made by Morgan, 25/10/99)
+
+1) Alastair
+ 1) Removed local function loadEnvironmentVariablesL() from
+ KPWINS\KP_INI.CPP. This change addresses ER5u software problem
+ EDNKDEY-4AAKEW "Long environment variables stop the emulator working".
+ The full emulator (from Mainline build 00019) still appears to work OK
+ without this function. Note that this change means that F32 will no
+ longer search the system path for DLLs to be loaded dynamically.
+
+ 2) Added code to make it possible to set the User::JustInTime() value
+ from the EPOC.INI file for WINS debug builds, using the syntax
+
+ JustInTime 1 # turn on just-in-time debugging
+ JustInTime 0 # turn off just-in-time debugging
+
+ Presumably only the latter will ever be used since JustInTime
+ debugging is enabled in WINS debug builds by default. The keyword is
+ case-insensitive. This change addresses ER5 defect EDN414664 "Should
+ be possible to set User::JustInTime from the EPOC.INI file".
+
+ 3) Refrozen EKERN.DLL for WINS/WINC so that the four functions referenced
+ by ordinal in source code appear at the start of the frozen .DEF file.
+ This means WINS/WINC executables linking to EKERN.LIB will need to be
+ rebuilt with the latest EKERN.LIB before they will run against the
+ latest EKERN.DLL.
+
+2) Morgan
+ 1) TMachineInfo::iXYInputPresent has become iXYInputType. Added
+ enum TXYInputType in e32hal.h. This can take one of the values
+ EXYInputNone, EXYInputPointer, EXYInputMouse (delivers absolute
+ values in mouse events), EXYInputDeltaMouse (delivers relative
+ values in mouse events).
+ 2) Removed MouseButtonDown and SetMouseButtonDown from UserHal and
+ Hal classes. Binary incompatable change. Incompatability limited
+ to the functions added last release.
+ 3) Removed unused events from TRawEvent: EFlipChange, ESimButton*
+ and EPointerMoveBy. Removed unused TFlipPos from TRawEvent.
+ 4) Updated MMAD emulated-mouse driver to use new API
+
+3) Alex
+ 1) Added a preliminary version of MMC stack controller and MMC media
+ driver (currently disabled) to the "peripheral bus" drivers family.
+ 2) Added Linda implementation of MMC stack ASSP layer.
+
+4) Bob
+ 1) Applied suggested fix to TLinda::ArtError and TLinda::IrError in
+ kamad\ka_linda.cpp
+ Reset the fifo only when error condition, not after every byte
+
+5) Pete
+ Change to bootloader to support CL-PS7211.
+ Temporarily disabled ADC on Cirrus Logic board due to problems with it.
+
+
+Version 1.02.250
+================
+(Made by Morgan, 27/9/99)
+
+1) Morgan
+ 1) Added the very random number generator Math::Random and Kern::Random.
+ Any device drivers that can derive random bits from their devices
+ should call Kern::RandomSalt(TUint aBitOfSalt) to mix up the kernel's
+ random pool. Only the LSB is used.
+ 2) MAWD Arm::IrqDispatch adds random salt from TWind::RtcTickCount()
+ MEIG Arm::IrqDispatch adds random salt from TEiger::RtcTickCount()
+ MISA Arm::IrqDispatch adds random salt from TSa1100::OstData()
+ MCGA Arm::IrqDispatch adds random salt from TCogent::TimerCounter()
+ 3) Added DPowerModel::NotifyEvent called from Kern::AddEvent. Override
+ this function in your power model to implement auto timeout behaviour.
+ eg
+ DMachinePowerModel::NotifyEvent()
+ { iLcdPowerHandler->ResetAutoSwitchOffTimer(); }
+ 4) Fixed HW IO mapping problem in the MMAD bootstrap
+ 5) Fixed \e32\rmmad\header.iby. Now includes screen size.
+
+2) Chris
+ 1) Fixed bug in TDMA (generic dma) affecting receive transfers large
+ enough to require breaking down into multiple dma operations.
+ 2) Changes to TLinda fns DmaSrcSize() and DmaDestSize().
+ 3) Changed ImpDma::GetInterrupt() and added code to set up the correct
+ device widths of peripherals for dma on Linda.
+ 4) Changed fast ir LDD to store ir frames on 4 byte boundaries.
+ 5) Changed PDD/LDD fast ir interface to be more generic and added
+ Caps/Config.
+ 6) Added incomplete Linda fast ir pdd(difilb). Supports 1M and 4M.
+
+3) Jonathan
+ 1) Fixed ER5u defect EDNGASR-46SD7V "Special keycodes conflict with
+ Unicode values" by making non-character keys start at 0xff80 and
+ special keys start at 0xff70, within the UNICODE private area.
+ inc\e32keys.h
+
+4) Petteri
+ 1) Added base mouse support.
+ [Note, this API has not been finalised. If you use these
+ APIs expect source and binary incompatable changes next
+ release]
+ Files changed:
+ Vmadlc\Vm_hw.cpp Usrc\Us_exec.cpp
+ Vmadlc\Vm_keyb.cpp Kpehal\Kph_inf.cpp
+ Vmadlb\Vm_hw.cpp Kamad\ka_inf.cpp
+ Vmadlb\Vm_keyb.cpp Kpepoc\Kp_dat.cpp
+ Inc\E32svr.h Bmarm\Euseru.def
+ Inc\E32hal.h Bmmad\Ekernu.def
+ Inc\U32std.h Bmawd\Ekernu.def
+ Inc\M32hal.h Bmcga\Ekernu.def
+ Inc\M32std.h Bmeig\Ekernu.def
+ Kaisa\Ka_inf.cpp Bmisa\Ekernu.def
+ Kacga\Ka_inf.cpp Bmros\Ekernu.def
+ Kaeig\Ka_inf.cpp Bwins\Euseru.def
+ Karos\Ka_inf.cpp
+ Keawd\Ka_inf.cpp
+ 2) Added virtual cursor support for Linda
+
+5) Simon
+ 1) MCGA will now 'dual boot' on CMA120 and CMA102
+
+6) Alastair
+ 1) Changed GROUP\GENERIC.INF so that ELOCL.DLL is not built for
+ THUMB.
+
+7) Malcolm
+ 1) Added new feature to rom.bat find template files by scanning
+ the e32/r*/ directories for .oby files. The config file now
+ simply specifies which one is the default - if this is not
+ present then another template is picked. The new
+ --list-templates option lists the known templates, along with
+ a description. The description is picked up from a line in
+ the .oby file starting //#NAME:
+
+ 2) Added ability to reuse rom.oby file in rom.bat (--reuse).
+ This is not recommended but is useful for quick .oby file
+ hacks. There is a heuristic employed to determine the ASSP of
+ the rom.oby file from its name, or it can be specified
+ directly.
+
+ 3) Changed MAWD, MEIG, MISA, MAD, SROS and SARM bootstraps to
+ pick up the kernel trace mask from the rom header (requires
+ rombuild > 125 to write the info there).
+
+8) Alex
+ 1) Fixed multiplier for TMillisecondTimer on MMAD, and adjusted
+ delay in keyboard driver.
+
+
+Version 1.02.197
+================
+(Made by Morgan, 26/8/99)
+
+SOURCE-ONLY RELEASE
+Built with MSVC6
+
+1) Jason
+ 1) Removed Casius MISA variant and all references to FPGA14 from MISA
+ code.
+ 2) Uncached screen chunk in \KAISA\KA_INI.CPP to fix stripy cursors.
+ 3) Update the MISA OST timer and match registers (KA_INI.CPP) over switch
+ off/on.
+ 4) MISA Seting of RTC clock now wait for one 32KHz tick.
+ 5) MISA Codec sample rate divider functions fixed.
+ 6) MISA Tick code fixed.
+ 7) InitSystemTime() implemented for MISA.
+ 8) MISA Bootstrap now uses correct MMU permissions for page tables.
+ Pagetables unlocked and locked (KA_ISA.CPP) in MISA sleep code.
+ 9) MISA Mini-Cache is now mappable and flushable, using new mappings of
+ EUserRwNotBuff, ESupRwNotBuff.
+ 10) \VISABA\VI_HW.CPP variant tidied up with Eikon friendly constants.
+ 11) \VISABA\VI_XYIN.CPP restructured.
+ 12) Added OS Timer Watchdog Enable to MISA sleep code and cleared all
+ the OST status bits after wakeup.
+ 13) Fixed possible MISA millisecond timer code bug.
+
+2) Alastair
+ 1) Removed ESOUND.LDD and ESDRV.PDD - these projects are now part of
+ E32TEST.
+ 2) Used #defines in GROUP\GENERIC.INF to ensure that KC_EXE.LIB is not
+ built for THUMB.
+ 3) Moved EUSER from BLD.INF to GENERIC.INF so that it's built only for
+ generic platforms rather than ASSP-specific platforms. Used #defines
+ so that it's not built for THUMB.
+ 4) Added empty target "FINAL" to GROUP\BOOTROM.MKE.
+ 5) Disabled VC6 warning C4414 - short jump to function converted to near,
+ in UPWINS\UP_I64.CPP and UPWINS\UP_REALX.CPP.
+ 6) Fixed BOOTROM.MKE so that SROS builds correctly report their
+ releasable.
+ 7) Added extension makefile KCARM\ABORTH.MKE to copy the correct abort
+ handler object file to \Epoc32\Build\...., and corresponding Perl file
+ KCARM\ABORTH.PL.
+ 8) Changed IBY files in ROMBUILD directory to #include the E32TEST and
+ F32TEST IBY files generated by ABLD TEST ROMFILE.
+ 9) Removed narrow frozen .DEF files.
+ 10) Re-frozen all .DEF files in new format so that the C++ name
+ appears with the mangled name for all exports and windiff can be
+ used to compare frozen .DEF files with generated .DEF files.
+
+3) Petteri
+ 1) Added a new variant (Vmadlc) for Linda Macro m1.3BB rack.
+
+ Files changed:
+ Group\Bld.inf Kbmad\E32var.iby
+ Kbmad\Rom.cmd Kbmad\Rom.oby
+
+ Files added:
+ Vmadlc\Distrib.txt Vmadlc\Vm_com1.cpp
+ Vmadlc\Vm_com2.cpp Vmadlc\Vm_hw.cpp
+ Vmadlc\Vm_kdata.cpp Vmadlc\Vm_keyb.cpp
+ Vmadlc\Vm_pbus.cpp Vmadlc\Vm_xyin.cpp
+ Inc\V32madlc.h Group\Cmkdlc.mmp
+ Group\Cmkylc.mmp Group\Cmxylc.mmp
+ Group\Dmtxlc1.mmp Group\Dmtxlc2.mmp
+ Group\Vmadlc.mmp Bmmad\Vmadlc.def
+ Bmmad\Vmadlcu.def
+
+4) Morgan
+ 1) Improved the MMAD TIdler to perform tickQ correction and to take notice
+ of active millisecond timers
+ 2) Wired in the TRtc class to the SetSystemTime function
+ 3) Corrected ImpMmu::FlushShadow for MMAD
+ 4) Added a flag to MilliSecondTimer so we can tell if the Millisecond
+ timers are being used while in Idle
+ 5) Bug fix to TDma::GetLargestXfer which was delivering odd count values
+ 6) Added initialisation function optimisation for pipe and copy commands
+ in ImpDma
+ 7) Incorporated TLinda::SetStateDiscriminator into the ImpDma
+ initialisation functions
+
+5) Pete
+ 1) E32 provides the following function to facilitate notification
+ of media change events:-
+ TInt UserSvr::MediaChangeNotify(TMediaDevice aDevice,TRequesStatus *aStat);
+ This currently only supports a single request to be outstanding on any
+ socket at any given time. Hence, for platforms which have more than one
+ socket, it is only possible to be notified of a media change on one of
+ these sockets. This has been changesd to allow a request to be
+ outstanding on each socket.
+ 2) Removed support for 2nd PC Card socket from VARMPD - no longer have a
+ rack with this h/w functional.
+ 3) Modified function UserSvr::ForceRemountMedia(TMediaDevice aDevice) to
+ allow a fixed drive as well as a removable drive to be specified. It
+ can now be called after having installed a new media driver to force
+ a remount on the appropriate drives. This fixes a problem where a new
+ driver for a fixed device is loaded but there is no way to force F32
+ to remount the local drives associated with the media driver.
+ 4) Modifications to Varmca variant:
+ - Alterations to reflect changed GPIO allocation for the LCD interface
+ on Rev.B evaluation board.
+ - Enabled diagnostic LED.
+ - Enabled SPI-ADC device.
+
+6) Chris
+ 1) Added mouse driver to Cogent + hardware cursor.
+ 2) Changed name of serial driver on Cogent to that expected by Romkit.
+ 3) Tidied up fast ir.
+ 4) Changed unit masks for Com2 and Com3 on Brutus.
+ 5) Modified Cogent serial drivers. Passes T_Serial.
+
+
+7) Jonathan
+ 1) Removed kc_exc.cpp and ke_exc.cpp from all distributions until IPR
+ issues are clarified.
+
+8) Dennis
+ 1) Added __SWITCH_TO_ARM and __END_ARM macros for use in test programs to
+ enable them to build in THUMB without rewriting assembler code.
+ 2) Modified test ROM build script to work with new GCC.
+ 3) Initialise .data and .bss for ROM-resident device drivers when driver
+ is loaded.
+ 4) Corrected TLocDrv::Caps(TDes8& aCapsBuf) so it doesn't assume that the
+ descriptor parameter is a TBuf8.
+ 5) Removed Kern::Printf() from Kern::PowerGood() - this causes the serial
+ driver to lock up since it gets called in the serial driver's ISR.
+ 6) Modifications to ROM.BAT:
+ Added --inst option to specify instruction set. If not specified,
+ defaults to first instruction set listed for the ASSP in ROM.CFG.
+ Build (--build) can now be UDEB or UREL only. If not specified,
+ defaults to the first build listed in ROM.CFG (ie UDEB).
+ Changed format of ROM.CFG - [VARIANTS] section has been scrapped.
+ [ASSPS] section now lists for each ASSP the ROMBUILD flags to use, the
+ variants supported and the instruction sets supported.
+
+9) Simon
+ 1) Mouse is now optional, ie doesn't hang if no mouse connected
+
+
+Version 1.02.196
+================
+(Made by William, 13.8.99)
+
+SOURCE-ONLY RELEASE
+Built with MSVC6 and ARMv4 (GCC 518).
+
+CHANGES TO RELEASABLE
+1) William
+ 1) CAKD*.MMP files no longer specify ASSP_LIBRARY EKERN.LIB, so that they
+ can be built correctly for THUMB.
+
+ 2) U32STD.H now defines __SUPPORT_THUMB_INTERWORKING for ARMv4T, using
+ #ifdef __ARM_ARCH_4T__ to distinguish between MAWD compiled with the
+ new GCC and MAWD compiled with the old toolchain.
+
+ 3) The GCC "_call_via_rX" helper functions required by THUMB code are
+ hacked into up_dll.cpp and uc_exe.cpp. This should be removed and
+ replaced by the proper GCC.LIB mechanism.
+
+ 4) RequestComplete tracing is now conditional on KTHREAD+KSEMAPHORE
+
+ 5) BOOTROM.MKE CLEAN target now removes intermediate .o files
+
+
+Version 1.02.195
+================
+(Made by Alastair, 2.8.99)
+
+SOURCE-ONLY RELEASE
+Built with MSVC6
+
+CHANGES TO RELEASABLE
+1) Alastair
+ 1) E32 now releases zip files for ARMI, ARM4 and THUMB in the same style
+ as it's other releasables. Note that generic EUSER.LIB and EDISP.LIB
+ are still released with the ASSP-specific releasables, though all
+ other generic stuff is now contained in the 3 new zip files. To use
+ these releasables it's necessary to use E32TOOLP version 120 and the
+ new GCC compiler.
+
+ This change is academic for this release since it's source-only, also
+ it has, in fact, been built with the old gcc compiler.
+
+1) Alastair
+ 1) Hopefully fixed ER5u defect EDNDMAI-49UE4V
+ '"KERN RE-ENTRANT" Panic' in KPWINS\KP_UTL.CPP by converting the
+ UNICODE RDebug::Print text to NARROW 256 characters at a time using
+ a stack variable rather than allocating space on the heap.
+
+ 2) Fixed ER5 defect EDNKDEY-45NHVH
+ "Unhandled exception checking for priority key (emulator only)" in
+ WSRC\KY_TRAN.CPP by making sure that capture key data is not left
+ uninitialised when Windows produces a character code that the EPOC
+ translation tables didn't.
+
+ 3) Fixed ER5u defect EDNWROS-46YC3V "Plat fault or Plat panic?" in
+ KPWINS\KP_UTL.CPP so that the Fault/Panic distinction is part of the
+ text inside the alert box rather than just in the title where nobody
+ ever thinks to look.
+
+ 4) Split BLD.INF into BLD.INF and GENERIC.INF with GENERIC.INF containing
+ details of those projects which are not ASSP-specific. This change
+ corresponds to changes in E32TOOLP version 120 and is designed to
+ support building E32 with the new GCC compiler for the new targets.
+ To build E32 it is now necessary to build the generic libraries, then
+ the ASSP-specific libraries, then the generic releasables, then the
+ ASSP-specific releasables.
+ Updated .OBY files so that, if E32 is built with the old GCC compiler,
+ they will look for the generic releasables in the right places. They
+ will need more updating to work with the new compiler though.
+
+ 5) Changed EKERN.MMP and KC_EXE.MMP so that EKERN links to KC_EXE.LIB
+ rather than KE_EXE.LIB under MAWD.
+
+ 6) Now building E(EXE|DLL).LIB rather than E(EXE|DLL).o under MARM and
+ E(EXE|DLL).obj under WINS. This means that using this version of
+ E32 requires E32TOOLP version 120.
+
+ 7) Changed E32DEF.H so that WINS/WINC warning C4710, about functions not
+ being inlined, is disabled for MSVC versions 5 or later, rather than
+ just MSVC5.
+
+ 8) Commented out user-side tracing macros under WINS/WINC builds in
+ INC\U32STD.H because they cause the kernel to go re-entrant. This
+ should be investigated further.
+
+ 9) Integrated changes for compiling with VC6 from Ann Windsor and William
+ Roberts. Changes to EKERNU.DEF and EUSERU.DEF mean that this release
+ of E32 will not build with MSVC5 and the import libraries from this
+ release will not be compatible with MSVC5.
+
+2) Malcolm
+ 1) Enabled debug monitor for SROS, and protected some MMU
+ instructions for single builds.
+ 2) Added new trace level, KMEMTRACE that dumps alloc/free/realloc and
+ chunk adjustments (chunks in SINGLE only) to the debug log
+
+3) Morgan
+ 1) Made Mmu::AllocPageTable public so it can be accessed by the debugger
+ 2) Added MMAD-specific debugger implementation, and null debuggers for
+ those platforms without support
+ 3) Moved useful ARM Mmu definitions into kcarm\kc_mmu.h
+ 4) MMAD debugger now updates the thread id register, remaps the Rom
+ as small pages, and allocates some free pages for SW breakpointing.
+ 5) Removed explicit references to variants from KC_UTL.CPP and removed
+ reference to the Eiger variant (V32ARM.H) from the global header
+ KC_STD.H. Pushed P::StartupBeep into the ASSP layer. Re-organised
+ P::OutputToCom1 functionality so the variant is only referenced in
+ ASSP layer. Changed P::ScreenInfo() to use the Hal function instead
+ of calling the variant directly.
+ 6) Defined TExtInterrupt in KC_STD.H, but it should really be moved into
+ the Eiger platform which seems to be its only client.
+ 7) Modified the Asic::Debug* functions for all ASSPs
+ 8) Added MMAD interfaces for the Psu and Rtc to V32MAD.H and wired them
+ into the kernel
+ 9) Implemented EDNWROS-49ZKUX "Unhelpful trace message"
+
+4) Dennis
+ 1) Added alignment checking on 16-bit descriptor functions in DEBUG mode.
+ 2) Modified User::HandleException() to trap leaves by the exception
+ handler and pass them on after clearing the last chance flag and doing
+ User::WaitForAnyRequest();
+
+5) Chris
+ 1) Added slow ir pdd for Linda (dmtxlb2).
+ 2) Added serial pdd for Cogent (datxcg1 and datxcg2).
+ 3) Made small change to Brutus slow ir pdd (ditxba2).
+
+
+Version 1.02.189
+================
+(Made by Kal Patel, 22nd July 1999)
+
+1) Jonathan
+ 1) TStringToDateTime::NextToken():
+ Fixed defect EDN830354: Allow am/pm designators to be non-alpha and >3
+ characters.
+ Reapplied and reworked an ER5 ICF (defect EDNANOE-49BFV2): Match
+ against abbreviated month names instead of leading substrings of
+ months.
+ usrc\us_parse.cpp
+
+2) Morgan
+ 1) Added an implementation of TMillisecondTimer for MMAD
+ kamad\ka_pic.cpp
+ 2) Implemented workaround for ARM915T MMU MCR instruction bug
+ Interrupts are disabled over writes to the domain access control
+ register
+ kcarm\kc_int.cpp
+ kcarm\kc_sched.cpp
+ inc\kc_std.h
+ 3) Fixed the definition of delta and tick TTimerModes
+ inc\v32linda.h
+ 4) Added a new class TIdler, that switches off rescheduling and the tick
+ during idle, and reenables it shortly before a timer is due.
+ kamad\ka_idle.cpp
+ kamad\ka_std.h
+ 5) Exported functions from DPowerModel for those power models that
+ are implemented outside of the platform kernel
+ inc\k32power.h
+ ksrc\ks_power.h
+ 6) Moved the MMAD variant to VMADLB, and invented a custom layer suitable
+ for MMAD. VARMLB.DLL is now VMADLB.DLL. CA*LB.DLL is now CM*LB.DLL.
+ DATXLB1.DLL is now DMTXLB1.DLL.
+ varmlb\*
+ inc\v32mad.h
+ inc\v32madlb.h
+ group\ca*lb.mmp
+ group\varmlb.mmp
+
+3) Alastair
+ 1) Added RESOURCE target to GROUP\BOOTROM.MKE.
+ 2) Removed defunct .DEF files from BSARM, BSCGA and BSROS.
+ 3) Removed defunct UPEPOC\UP_CON.CPP.
+ 4) Removed defunct BLD.CMD files from various directories.
+ 5) Updated GROUP\E32.FTC to include the MCGA releasables.
+ 6) Changed GROUP\BOOTROM.MKE to copy KBMCGA\COGENT.BIN to
+ \EPOC32\Release\MCGA\BOOTROM.BIN. Updated KBMCGA .OBY files
+ accordingly.
+ 7) Changes to support building with new compiler (*.oby files,
+ /group/mnt.bat files, /group/bld.inf files etc)
+
+4) Simon
+ 1) Fixed problem with cogent timer interrupt going off for no good reason
+ kacga\ka_pic.cpp
+ 2) Fixed problem in vcgac1\va_keyb.cpp that caused intermittent exceptions
+
+5) Malcolm
+ 1) Added new RAM Loaded code functionality
+ 2) Modifications for Unicode SROS
+ 3) Incorporated Kista-Patch-Baseport-3.00-990717A
+ kbros/rose.inc
+ vrosr1/va_xyin.cpp
+ karos/ka_rose.cpp
+ INC/D32COMM.H, INC/V32Rose.h
+ vrosr1/va_coms.cpp
+ group/DATXR11.MMP
+ group/bld.inf
+
+6) Kal
+ 1) Added the Aort handler functionality for flash filing system use
+ karos/ka_ini.cpp
+ karos/ka_excep.cpp
+ karos/ka_std.h
+ karos/ka_rose.cpp
+ WSRC/wd_rose4.cpp
+ group/EKERN.MMP
+ INC/V32Rose.h
+ 2) Added Fast Timers on A1C
+ karos/ka_rose.cpp
+ karos/ka_pic.cpp
+ karos/ka_std.h
+ INC/distrib.txt
+ INC/V32FTick.h
+ group/bld.inf
+
+
+Version 1.02.188
+================
+(Made by Dennis, 13th July 1999)
+
+1) Morgan
+ 1) Removed the SPI controller from MMAD platform
+ kamad\ka_spi.cpp
+ kamad\ekern.mmp
+ kamad\ka_psu.cpp
+ 2) Used a more efficient method for draining the write buffer on MMAD
+ kcarm\kc_mmu.cpp
+ kamad\ka_ini.cpp
+ 3) Included a missing call to POS in the slow swi dispatcher
+ kcarm\kc_int.cpp
+ 4) Frozen BMMAD
+ bmmad\*.def
+ 5) Added a gcc-helper static library (EGCC.LIB) which currently
+ only contains the __fixuns* helper functions
+ upepoc\up_gcc.cpp
+ group\egcc.mmp
+ 6) Implemented RTC emulation
+ kamad\ka_utl.cpp
+ kamad\ka_std.h
+ kamad\ka_pic.cpp
+ 7) Added state discriminator functions to TLinda and updated Linda Dma
+ kamad\ka_dma.cpp
+ kamad\ka_linda.cpp
+ inc\v32linda.h
+
+2) Petteri
+ 1) Added an improved version of
+ varmlb\va_keyb.cpp
+
+3) Alastair
+ 1) Added Graham Asher's updates to his change to UMATH\UM_DTOR.CPP so that
+ it builds in narrow variants.
+ 2) Added GROUP\BOOTROM.MKE - a bldmake-compatible custom-build makefile
+ for building bootstraps.
+ 3) Removed some hacks from MNT.BAT now that MAKMAKE from E32TOOLP version
+ 109 builds static libraries to \EPOC32\Release\MARM rather than
+ \EPOC32\Release\MEIG.
+ 4) Moved \e32\inc\conswins.def to \e32\inc\econs.def and listed it for
+ export to \epoc32\release\wins\econs.def. Made a corresponding change
+ to \e32\inc\consmarm.def and removed \e32\inc\consmisa.def.
+ 5) Moved the implementation of the RConsole and TConsoleKey classes into
+ EWSRV.DLL from ECONS.DLL. Stopped exporting all functions from the
+ CConsoleTextWin Class under WINS/MARM except the function to create a
+ new console. Removed the dummy export from the text window server.
+ This means there is no longer a mutual link-time dependency between
+ ECONS.DLL and EWSRV.DLL - ECONS.DLL merely depends upon EWSRV.DLL, and
+ the WINS ECONS.DLL has the same API as the WINC one. and not vice
+ versa.
+ 6) Added fetcher definition file, E32.FTC, to the group directory.
+ 7) Fixed ER5U defect EDNABRY-48YFUC "Compiling E32 with MSVC6 reveals
+ problems with TPtr8 and TPtr16 copy constructors."
+ Fixed in USRC\US_DES8.CPP by taking the contents of the function
+ TPtr8::Set(TPtr8 &aPtr) function and adding it to function
+ TPtr8::TPtr8(const TPtr8& aTPtr). This change is not binary compatible
+ backwards with code which calls the TPtr8 copy constructor either
+ explicitly or implicitly and relies upon the previous behaviour of the
+ copy constructor. The previous behaviour merely made sure that the
+ copied TPtr pointed to the same descriptor as the original TPtr, while
+ the new behaviour also makes sure that the TPtr's iType is set
+ correctly.
+ These changes were necessary for TPtr8s to work correctly when compiled
+ with MSVC6. I have made corresponding changes to the TPtr16 copy
+ constructor.
+ 8) Changed KPWINS\KP_GUI.CPP so that the Windows character code
+ translation is suppressed if the Ctrl, Alt and Shift keys are all
+ depressed. This means that the heap-checking code for APPs which used
+ the Ctrl-Alt-Shift-A combination will now work again, as the EPOC key
+ translation will not be overridden by the Windows translation.
+
+4) Chris
+ 1) Added export to mmu to enable creation of DHardware chunk from Ram.
+ 2) Slight change to TDma to allow it to break up non-contigous transfer
+ buffers.
+ 3) Added fast infra-red LDD(Efir) to misa and mmad and a fast infra-red
+ PDD(Difiba) to misa.
+ 4) Changes to TSa1100 variant class to implement infra red and dma on
+ misa.
+ ImpDma class impemented also for misa.
+ 5) Added 572000,1152000 and 4000000 baud defs to d32comm.h.
+
+5) Dennis
+ 1) Added routine ImpExc::AdjustRegisters() to restore registers on ARM
+ processors to allow an aborted instruction to be retried.
+ 2) Added TException::Bind(), TException::UnBind() exported functions to
+ allow device drivers to bind to exceptions.
+ 3) Various Snowdrop-specific fixes which didn't make it for ER5.
+ (Euro, Digitiser factory settings, Windermere DRAM refresh, ROM size,
+ digitiser EEPROM calibration)
+ 4) Prefetch aborts now have exception ID EExcCodeAbort instead of
+ EExcGeneral.
+ 5) Added ExecHandler::RomHeaderAddress() to windermere kernel.
+ 6) Rearranged VAWDB1U.DEF so that VariantInitialise__Fv is at ordinal 1
+ (this is necessary or else nothing works).
+ 7) Fixed bug in new RTest where RDebug::Printf(_L("<string>")) would panic
+ if <string> contained a % character. This was due to <string> being
+ passed into AppendFormatList which was then interpreting the % as a
+ format specification.
+ 8) Modified assembler code in EUSER to allow thumb interworking by making
+ all subroutine returns and indirect function calls use the BX
+ instruction. Macros have been used so that the ARM-only version with
+ no BX instructions can still be built - this is necessary for
+ StrongARM builds.
+
+ Macros employed are:
+
+ __JUMP(cc,r) = BXcc r or MOVcc PC, r
+ __POPRET(rlist) = LDMFD SP!, {rlist,lr} \ BX lr or LDMFD SP!,{rlist,pc}
+ __CPOPRET(cc,rlist) = LDMccFD SP!, {rlist,lr} \ BXcc lr or LDMccFD SP!, {rlist,pc}
+
+ NOTE: Thumb interworking is still disabled by default, since the new GCC
+ is not yet fully deployed.
+
+ 9) Made minimal modification to EKERN to permit thumb user code to execute
+ correctly. This involves changing two instances of "mov pc, lr" in the
+ SWI handler to __JUMP(,lr) and also involves changing
+ DArmPlatThread::CallFunction to use separate routines depending on
+ whether an ARM or THUMB context is being modified. Also, when saving
+ context following a SWI call, the saved PC points to a BX instruction
+ instead of to the return address from the Exec:: function.
+
+ NOTE: All supervisor mode code is expected to be ARM. Much more
+ extensive modification of the kernel would be required to permit THUMB
+ device drivers.
+
+ 10) Compiled and tested E32 with the new version of GCC. This produces
+ several warnings, mostly "comparison of signed and unsigned", "ANSI
+ C++ does not permit declaration without type", "Taking address of
+ temporary" and "XXX declared but not used" (for variables or functions
+ only used from within assembler code). Modified the source to remove
+ these warnings.
+
+ 11) Compiled and tested E32 using THUMB test executables. These all work
+ apart from those which contain ARM assembler code. Disabled
+ breakpoint exception since this can crash the kernel with an alignment
+ fault if an undefined instruction is encountered in THUMB code.
+ Fixing this properly would require a lot of work on the debugger to
+ fully support THUMB.
+
+ NOTE: To build THUMB executables, the _call_via_r0() helper functions
+ are required. These were added to EEXE.O for testing purposes, but will
+ eventually be in the GCC helper library.
+
+ 12) Modified TDes::AppendFormatList() so that variable precision
+ specifications are now allowed, and so that the precision
+ specification is also applied to strings.
+
+6) Simon
+ 1) Improved ps/2 keyboard initialisation within kacga
+
+7) Mark
+ 1) Enabled unicode WINS/WINC to run on Windows 9x. Introduced euniw.dll
+ to convert between unicode and relevant narrow Win32 functions.
+ Added exported set of functions to euser.dll that return a pointer
+ to either the relevant 'W' Win32 function or a wrapper function in
+ euniw.dll. These functions and the initialisiation of the function
+ pointers is implemented in upwins\up_uansi.cpp.
+ 2) Changed unicode to narrow WINS/WINC conversion from UTF-8 to
+ CP_ACP in WinCOutput::Write and Debug::DebugFunction.
+
+Version 1.02.187
+================
+(Made by Alastair, 9.6.99)
+
+
+1) Jason
+ 1) Added sleep and wakeup code for MISA
+ 2) Enabled LCD and Keyboard for Brutus wakeup.
+ 3) Added MCP controller accessor functions for MISA
+ 4) Modified power model to share MCP clock
+ 5) Added definitions for the Brutus UCB1200 codec chip.
+ 6) Added touch screen controller for Brutus, including touch to wakeup.
+ 7) Fixed Brutus keyboard controller to not enable interrupt edges that it
+ does not use.
+ 8) Added the missing function TSa1100::UartTxBusy() to MISA
+ \inc\v32s1100.h
+ \v32ucb12.h
+ \kaisa\ka_isa.cpp
+ \ka_ini.cpp
+ \ka_power.cpp
+ \ka_power.h
+ \kbisa\sa1100.inc
+ \sa1100.s
+ \visaba\vi_hw.cpp
+ \vi_keycn.cpp
+ \vi_xyin.cpp
+
+2) Morgan
+ 1) Made Mmu::UnlockPageTables and Mmu::LockPageTables public so
+ code that calls Mmu::LogicalToPhysical() can unlock and
+ access the page tables.
+ \inc\m32hal.h
+ 2) Unlocked the page tables in TDma::NextBlock() function
+ \kpepoc\kp_dma.cpp
+
+3) Petteri
+ 1) Added Linda serial driver.
+ 2) Added 230.4K speed to d32comm.h and modified old serial drivers
+ to dislike it.
+ \group\datxlb1.mmp
+ \inc\d32comm.h
+ \v32linda.h
+ \kamad\ka_linda.cpp
+ \varmca\va_com1.cpp
+ \va_com2.cpp
+ \varmcl\va_com1.cpp
+ \va_com2.cpp
+ \varmlb\va_com1.cpp
+ \varmp2\va_com1.cpp
+ \varmpb\va_com1.cpp
+ \varmpc\va_com1.cpp
+ \va_com2.cpp
+ \varmpd\va_com1.cpp
+ \va_com2.cpp
+ \vawdb1\va_com1.cpp
+ \va_com2.cpp
+
+4) Graham Asher (merged by Jonathan)
+ 1) Implement standard Unicode collation and add new collation functions
+ to allow loose matching.
+ 2) Fill up all the available TLanguage slots (00 to 99); codes added
+ include those requested for Roxette; this is a provisional solution
+ pending the introduction of a saner language and locale number API.
+ 3) Fix problems in TLex16::Val(TRealX&,TChar) &
+ TLex16::Val(TReal64&,TChar) in Unicode-to-8-bit conversion (defect
+ EDN769607).
+ 4) Obsolete functions yet to be removed:
+ TInt TDesC16::CompareC(const TDesC16& aDes,const TInt16*
+ aCollationRules) const;
+ TInt TDesC16::CompareC(const TDesC16& aDes,TUint32
+ aDesiredCollationRulesId,TUint32&
+ aActualCollationRulesId) const;
+ static TInt Mem::CompareC(const TUint16* aLeft,TInt aLeftL,const
+ TUint16* aRight,TInt aRightL,const TInt16*
+ aCollationRules);
+ static TInt Mem::CompareC(const TUint16* aLeft,TInt aLeftL,const
+ TUint16* aRight,TInt aRightL,TUint32
+ aDesiredCollationRulesId,TUint32&
+ aActualCollationRulesId);
+ static TInt Mem::CollationRuleSets();
+ static TInt Mem::CollationRuleSetId(TInt aIndex);
+ static const TInt16* Mem::CollationRuleSetByIndex(TInt aIndex);
+ static const TInt16* Mem::CollationRuleSetById(TUint32
+ aDesiredId,TUint32&
+ aActualId);
+
+5) Jonathan
+ 1) Fixed "ambiguous overload for `bool ? TChar : char'" errors from new
+ gcc compiler.
+ umath\um_rtod.cpp
+
+6) Alastair
+ 1) To build this release of e32tools you'll need the latest version - 108
+ - of E32toolp. If you're going to use this release at all, you'll
+ need to be building your component with the latest version of
+ e32toolp, since import libraries are only released in the MARM release
+ and WINS debug directories and also because EDLL.O and EEXE.O won't
+ link properly with older versions of e32toolp.
+ 2) Renamed MARM platform to MEIG and SARM platform to SEIG just as far as
+ E32 is concerned. Other components will still build for the MARM (and
+ SARM) platforms. This change means that rombuild obey files will need
+ to change to reflect the new location of e32 releasables in
+ \EPOC32\Release\Meig instead of \EPOC32\Release\Marm.
+ 3) Changed zips of releasables put onto the network. There is now one zip
+ file for each platform. There is also a zip file for exported header
+ files. Hence, the contents of S:\e32\zip includes
+ export.<ver>, wins.<ver>, meig.<ver>, misa.<ver> ,mawd.<ver> winc.<ver>.
+ Each of the meig, misa and mawd zip files should contain everything
+ necessary for building components which depend on E32 for marm.
+ The files within these zip files now also have full pathnames so ensure
+ you unzip them into the root of your EPOC drive with any flags required
+ to recreate the directory structure.
+ 4) Added new MAKMAKE keyword ASSPEXPORTS to various .MMP files so that
+ they search ASSP-specific deffile directories rather than CPU-specific
+ deffile directories by default. E.G. EKERN.DLL built for narrow MISA
+ REL will refer to \E32\BMISA\EKERN.DEF rather than
+ \E32\BMARM\EKERN.DEF. These .MMP files are for EKERN, EPBUS, VARMCL,
+ VARMLA, VARMLB, VARMP2, VARMPB, VARMPC, VARMPD, VAWDB1, VISABA,
+ VISACA, VROSR1, VCGAC1, VARMCA. This keyword means that the import
+ library for a project build for MEIG will go into
+ \EPOC32\Release\MEIG\<rel|urel>\ rather than
+ \EPOC32\Release\MARM\<rel|urel>\.
+
+ Where .MMP files have links to the import libraries for these
+ components I have listed the libraries with new keyword ASSPLIBRARY
+ and taken them out of any existing LIBRARY statements. This ensures
+ that the generated- makefile will search in the correct place for the
+ import library. Any other components linking to these libraries will
+ have to do the same thing.
+ 5) Kernel include headers are now exported to \EPOC32\Include\Kernel
+ rather than \EPOC32\Include, so if your component includes these
+ headers you'll need to add \EPOC32\Include\Kernel as a SYSTEMINCLUDE
+ file in your .MMP file.
+ 6) Added new command, MNT CHECKREL, to check that all releasables are
+ present before doing an MNT PUTREL.
+ Before doing MNT CHECKREL or MNT PUTREL call BLDMAKE -v RELFILES to
+ create the lists of releasables.
+ 7) Changed edll, exdll, eexe and kc_exe so that they all build as static
+ libraries rather than object files in accordance with ER5u makmake
+ changes.
+ 8) Changed second uids in device driver .MMP files to zero so that makmake
+ will apply the correct ones automatically.
+ 9) Changed .MMP files to take advantage of changes in makmake .MMP
+ #defines.
+ 10) Replaced all B[plat].PRJ files for use with BLDMAKE with BLD.INF in
+ accordance with latest BLDMAKE changes.
+ 11) Moved ETIMR and T_DEVC to project E32TEST.
+ 12) Removed all E*.REL files from GROUP directory and changed MNT.BAT so
+ that MNT PUTREL looks for .REL files generated by BLDMAKE instead.
+ Updated BLD.INF accordingly.
+ 13) Changed #defines in the following files now that __MEIG__ is being used
+ to mean __MARM__ and __MARM__ is being used to mean ARM CPU:
+ INC\U32STD.H, INC\M32STD.H, PSRC\PS_PCCD.CPP,
+ KCARM\KC_INT.CPP, DPEPOC\D_MEDINT.CPP, DPEPOC\D_MEDCRR.CPP,
+ DPEPOC\D_MEDCRM.CPP, DPEPOC\D_MEDATA.CPP.
+ 14) Removed EVALID.PL and EVALID.BAT from GROUP dir now that this version
+ of EVALID is being released as part of E32TOOLP.
+ 15) Created directory \E32\BMEIG. Moved .DEF files for the following
+ projects from \E32\BMARM\ to \E32\BMEIG:
+ EKERN, EPBUS, VARMCL, VARMP2, VARMPB, VARMPC, VARMPD.
+ 16) Removed unnessary __XCON__ #defines and swapped them with __WINC__
+ instead where necessary.
+ 17) Removed XWSRV.MMP, XPBUS.MMP, XCONS.MMP, EXYIN.MMP and EKEYB.MMP - they
+ were no longer required now that libraries can be built separately.
+ Note that this means the import libraries must be built before building
+ the other releasables because of the mutual imports between some E32
+ Dlls.
+ 18) Changed variant .MMP files to link to the respective variant versions
+ of exyin.lib and ekeyb.lib now that exyin.lib and ekeyb.lib are no
+ longer built as import libraries.
+ 19) Removed WINS #defines from around the dummy export for the text window
+ server so that it has a dummy export for other builds. Frozen the dummy
+ export in \E32\BMARM\EWSRV.DEF.
+ 20) Removed export command from MNT.BAT and EXPORT.PL from group directory
+ now that and equivalent command is provided by BLDMAKE.
+ 20) CONSWINS.DEF, CONSMARM.DEF and CONSMISA.DEF are now exported to
+ directory \EPOC32\Release\<Platform>\ rather than \EPOC32\Include.
+ 21) Changed #defines in K32ADDR.H, U32STD.H, V32COG.H in accordance with
+ makmake #define changes for __SROS__ and __SCGA__.
+ 22) Adjusted BLD.INF so that kernel headers are exported to
+ \EPOC32\Include\Kernel\ rather than \EPOC32\Include. This means that
+ any projects requiring the kernel headers will have to have
+ \EPOC32\Include\Kernel added to the list of SYSTEMINCLUDE paths within
+ their .MMP files.
+ 23) Removed all .DEF files from the B<plat> directories which are now
+ referenced in the BMARM directory. Renamed BSROS BMROS and removed
+ BSARM and BSCGA.
+ 24) Added extra commands to MNT.BAT to copy edll.o and eexe.o from the MEIG
+ release directories to the MARM ones pro tem, and to zip them up for
+ MEIG, MAWD and MISA.
+ 25) Changed rom.oby files in KBARM and KBSARM directories to incorporate
+ changes resulting from the new way E32 is built. A few changes in
+ other rom.oby files may also be required.
+ 26) Excluded Graham Asher's change to UMATH\UM_DTOR.CPP since they won't
+ build in narrow variants.
+ 27) Fixed up MEIG EKERN.DEF following Pete's DMedia changes.
+ 28) Changed P::Print so that in release builds it uses Win32's
+ OutputDebugString() rather than putting up a message box. This has
+ always been the behaviour in debug builds. As a result of this change,
+ test output will no longer appear in an annoying sequence of message
+ boxes.
+
+7) Pete
+ 1) Modification to DMediaDriver class so a media driver
+ can be configured to allow read/write/format requests simultaneously
+ with each other. By default, a driver only allows one
+ request to be outstanding at any time but by setting the
+ DMediaDriver member iFlags to KMediaDrvMultipleReqs,
+ a read/write and format command may each be outstanding at a given
+ time.
+ \ksrc\ks_locd.cpp
+ \inc\k32std.h
+ \inc\k32std.inl
+
+Version 1.02.186
+================
+(Made by Malcolm, 21st May 1999)
+
+Petteri
+ 1) Added a new variant (Varmca) for the Rev.A of the new Cirrus
+ Logic 711X evaluation board. This port is not complete: digitiser
+ driver, most of ADC code, second serial port and some other
+ small things are missing. Also, the board is still evolving.
+
+ New files added:
+ Varmca\Va_c6700.cpp Group\Cakdca.mmp
+ Varmca\Va_com1.cpp Group\Cakyca.mmp
+ Varmca\Va_com2.cpp Group\Caxyca.mmp
+ Varmca\Va_hw.cpp Group\Dasnca.mmp
+ Varmca\Va_kdata.cpp Group\Datxca1.mmp
+ Varmca\Va_keyb.cpp Group\Datxca2.mmp
+ Varmca\Va_pbus.cpp Group\Varmca.mmp
+ Varmca\Va_sdrv.cpp Inc\V32armca.h
+ Varmca\Va_spi.cpp
+ Varmca\Va_xyin.cpp
+ Varmca\Va_std.h
+
+ Old files modified:
+ Group\Bmarm.prj
+ Group\Emarm.rel
+ Kbarm\E32var.iby
+ Kbarm\Rom.oby
+ Kbarm\Setvars.cmd
+ ( and also:
+ Kamad\Ka_linda.cpp
+ Inc\V32linda.h )
+
+Jason
+ 1) MISA Idle code fix.
+ \kaisa\ka_utl.cpp
+ \kcarm\kc_int.cpp
+ \kbisa\sa1100.s
+
+Jonathan
+ 1) Added Protea, Cassius and inc{c|k} files to distrib.txt files
+ bmarm\distrib.txt
+ bmisa\distrib.txt
+ inc\distrib.txt
+ group\distrib.txt
+
+Version 1.02.185
+================
+(Made by Malcolm, 14th May 1999)
+
+Malcolm et al.
+ 1) Prepared E32 for automatic building and testing. Each kbXXX
+ directory should now have the following files:
+
+ rom.cmd that takes an .oby file as the first parameter (and
+ then the standard build/variant as before).
+ test.oby that builds a rom with all the test code for that
+ platform. Test.oby should also include batch files called
+ z:\test\e32auto.bat, z:\test\f32auto.bat and
+ z:\test\allauto.bat that run respectively the e32, f32 and all
+ tests for this platform. For now, these are taken from
+ \e32test\group./
+ bld.cmd that creates udeb and urel roms, given that all of
+ e32, f32 and the test suites have been built. Typically this
+ makes the bootstrap code then calls rom.cmd.
+
+ This change has been implemented for misa, marm, mcga & sros.
+
+
+Alastair
+ 1) Changed RDebug::Print for WINS/WINC so that output is appended to file
+ EPOCWIND.OUT in the PC's temporary directory, as well as being sent
+ where it is currently. In UNICODE builds, the output is converted to
+ UTF-8 before being appended to the file.
+ 2) Changed WINC Console output under UNICODE builds so that it can be
+ redirected to a file. The output is converted to UTF-8 before being
+ sent to the console.
+
+Simon
+ 1) Merged in Cogent
+ \kacga\*
+ \bmcga\*
+ \vcgac1\*
+ \wsrc\wd_vgacga.cpp
+ \wsrc\wd_vtcgakb.cpp
+
+ 2) Modified coproc related bits for ARM4 on Cogent
+ \kcarm\kc_sched
+ \kcarm\kc_mmu
+
+Petteri
+ 1) Minor Linda screen and keyboard related changes.
+ \kamad\ka_ini.cpp
+ \kamad\ka_linda.cpp
+ \inc\v32linda.h
+ \varmlb\va_hw.cpp
+ \varmlb\va_keyb.cpp
+ \wsrc\wd_mad.cpp
+
+
+Malcolm
+ 1) Changes to mnt.bat. Directories are now enummerated in
+ dir.prj rather than being hard-coded into mnt.bat all over the
+ place. Two perl helper scripts have been created to interface
+ to PVCS.
+ \group\mnt.bat
+ \group\dopvcs.pl
+ \group\lock.pl
+ \group\dir.prj
+
+
+Petteri
+ 1) Minor changes in order to tidy up DisplayOn()
+ \kamad\ka_ini.cpp
+ \inc\v32linda.h
+ \varmlb\va_hw.cpp
+ \wsrc\wd_mad.cpp
+
+
+Petteri
+ 1) Speed improvements to Linda screen driver.
+ \wsrc\wd_mad.cpp
+
+ 2) Modified keyboard related files so that Linda keyboard
+ driver works properly.
+ \varmlb\va_keyb.cpp
+ \varmlb\va_kdata.cpp
+ \group\cakylb.mmp
+
+
+Malcolm
+ 1) Upgraded the MNT DISTRIB command to cope with per-file
+ inclusion/exclusion. Now uses perl to parse distrib.txt
+ files. These files have changed in format. The format is
+ now lines of the format:
+ <filename> <licensee>
+ If the filename is Default, then all the files in this
+ directory will be included. If the licensee text contains
+ "Epoc" then this is part of the generic release.
+ To always exclude a file I suggest using a licensee of "Never".
+ Comments can be started with the # character and last to the
+ end of the line. \inc\distrib.txt and \group\distrib.txt files
+ are good examples.
+ The distrib.txt files themselves are never included.
+ At the moment, this script requires pkzip version 2.5, called
+ pkzip25 to be in the path. This is due to limitations with
+ the previous versions of pkzip.
+ \group\distrib.pl
+ \group\mnt.bat
+ \*\distrib.txt
+
+ 2) Fixed single process scheduler bug
+ \kcarm\kc_sched.cpp
+
+ 3) Merged in Simon's automatic test changes.
+ \usrc\us_test.cpp
+ \inc\e32test.h
+
+ 4) Added export.pl that will export E32 headers appropriately.
+ \group\export.pl
+
+
+Petteri
+ 1) Added text screen driver for Linda
+ \wsrc\wd_mad.cpp
+ \group\edisp.mmp
+
+
+Malcolm
+ 1) Removed all the li.prj files & moved the distribution comments
+ to distrib.txt files. Updated mnt.bat to deal with this.
+ \group\mnt.bat
+ *\li.prj
+ *\distrib.txt
+
+ 2) Boilerplated Roxette sources
+ \vrosr1\*
+ \karos\*
+ \kbros\*
+
+
+Malcolm
+ 1) Major reorganisation of the E32 tree. Tags: Pre-ER5u-Reorg is
+ before this, Post-ER5u-Reorg is after it.
+
+ What was upmarm and upmx86 has had the common parts extracted
+ into upepoc and the architecture dependant bits moved to
+ ucmarm and ucmx86 respectively.
+ \upmarm\*
+ \upmx86\*
+ \ucmarm\*
+ \ucmx86\*
+ \upepoc\*
+ group\ekern.mmp
+ group\eexe.mmp
+ group\xcons.mmp
+
+ 2) Ucdt has been moved over to Usrc
+ \ucdt\*
+ \usrc\*
+ group\euser.mmp
+
+ 3) Roxette (SROS) has been merged in
+ \karos\*
+ \kbros\*
+ \vrosr1\*
+ \bsros\*
+ group\ekern.mmp
+ group\bsros.prj
+ group\esros.rel
+ group\euser.mmp
+ group\ekern.mmp
+ group\edisp.mmp
+ group\eexe.mmp
+ group\ekdata.mmp
+ group\inck.rel
+ group\vrosr1.mmp
+ wsrc\wd_rose*
+
+ 4) Removed EPBUS reference in epbus
+ group\epbus.mmp
+
+ 5) Added support for screen dimension keys (flip keys)
+ inc\e32keys.h
+ inc\e32panic.h
+ usrc\us_evnt.cpp
+
+ 6) Changes to timers to disambiguate periodic and locked timers for the
+ lower layers by encoding a value in the repeat field
+ ksrc\ks_tim.cpp
+ inc\k32std.h
+
+ 7) New function UserSvr::RomHeaderAddress(), replacing the use of
+ KRomLinAddr constant. This is so the F32 is single-process agnostic.
+ All address constants have been moved to k32addr.h
+ inc\k32addr.h
+ kpepoc\kp_ini.cpp
+ inc\u32std.h
+ inc\e32rom.h
+ inc\e32svr.h
+ inc\m32hal.h
+
+
+Jason
+ 1) Added debug monitor for MISA
+ \KAISA\KA_MON.CPP
+ \INC\M32STD.H
+ \GROUP\EKERN.MMP
+
+Morgan
+ 1) Upgraded Dma abstraction to cope with transfers across page boundaries
+ \INC\M32STD.H
+ \KAMAD\KA_DMA.CPP
+ \KPEPOC\KP_DMA.CPP
+ 2) Fixed function prototype for DPowerHandler::SetRequirement(TUint &aState)
+ \inc\k32power.h
+ \ksrc\ks_power.cpp
+ \b*\ekern*.def
+ 3) Implemented Hal::ModifyLedMask()
+ \kpehal\kph_inf.cpp
+ 4) Fixed key translator to use User::LowerCase instead of User::Fold
+ for EMatchKeyCaseInsens
+ \wsrc\ky_tran.cpp
+ 5) Merged in changes for MMAD
+ \inc\u32std.h
+ \inc\v32linda.h
+ \kbmad\*
+ \kamad\*
+ \varmlb\*
+ 6) Corrected remote serial screen cursor positioning
+ \wsrc\wd_vt100.cpp
+ 7) Fixed mismatched #defines of
+ __CPU_SPLIT_TLBS and __CPU_SPLIT_TLB
+ __CPU_CACHE_CONFIGURABLE and __CPU_CACHE_SELECTABLE
+ \kcarm\kc_mmu.cpp
+ 8) Removed NotBuffered attribute from the read-only EKernelCode and
+ EUserCode chunks
+ \kcarm\kc_mmu.cpp
+ 9) Added Platform dependent constants for page table attributes
+ \kcarm\kc_mmu.cpp
+ 10) Integrated the debug monitor into MMAD
+ \kamad\ka_mon.cpp
+ \inc\m32std.h
+ 11) Uncommented the two lines of code that flush the D-Cache on
+ split cache processors
+ \kcarm\kc_sched.cpp
+ \kcarm\kc_mmu.cpp
+ 12) More bug fixes for MMAD
+ \kamad\ka_linda.cpp
+ 13) Implemented Rom groping in the bootstrap
+
+
+Jonathan
+ 1) Fixed fix for EDN430762 in 170; trap handler was not being correctly
+ zeroed.
+ kpwins\kp_utl.cpp
+ 2) Reinstated unused functions SetLine and GetLine cos they're pure
+ virtual in the base class and so need to exist.
+ wsrc\wd_wins.cpp
+ 3) Made RTest::Getch() pause for input even in non-manual mode.
+ usrc\us_test.cpp
+
+Version 1.02.181
+================
+(Made by Pete, 5th May 1999)
+
+1) Pete
+ 1) Added the (exported) function:-
+ TBusLocalDrive::Format(TInt aPos,TInt aLength)
+ so that it is possible to format just a part of a
+ drive.
+ 2) Changed the local drive allocation for Brutus/WINS as follows:-
+
+ Local-Drive-Num Assignment
+ (Let-EPOC/WINS)
+ 0 (C:/Y:) EFixedMedia0 (Internal Ram)
+ 1 (D:/X:) ERemovableMedia0 (1st partition on PC Card Socket0)
+ 2 (E:) ERemovableMedia1 (1st partition on PC Card Socket1)
+ 3 (F:) ERemovableMedia0 (2nd partition on PC Card Socket0)
+ 4 (G:) ERemovableMedia1 (2nd partition on PC Card Socket1)
+ 5 (H:) ERemovableMedia0 (3rd partition on PC Card Socket0)
+ 6 (I:) ERemovableMedia1 (3rd partition on PC Card Socket1)
+ 7 (J:) Not used
+ 8 (K:/W:) EFixedMedia1 (Flash File System)
+
+ 3) Backed out the change made in V180 to TTrapK::Trap() in kpwins\kp_utl.cpp as
+ this is suspected to be causing problems in WINS Unicode builds.
+ 4) Fixed a problem with the function ImpHal::Idle() on ISA builds
+ (KAISA\KA_UTL.CPP).
+ 5) Fixed a problem with EPBUS.DLL which resulted in an exception
+ if an attempt was made to open a media driver for a peripheral
+ bus device (ie derived from DPBusMediaDriver) on an
+ internal drive. This typically only causes a problem on machines
+ which have a local drive designated as an internal drive in addition
+ to the standard Internal Ram drive (ie EFixedMedia1). This isn't a
+ problem on Snowdrop/Protea. There generally isn't a problem on the
+ internal Ram drive (ie EFixedMedia0) since the IRAM media driver
+ (MEDINT.PDD) opens successfully on this device before any drivers for
+ removable devices. (It would have caused a problem if ATA media driver was
+ loaded before the IRAM media driver).
+ 6) Modified E32VAR.IBY and ROM.OBY in \KBISA to allow ISA UNICODE rom's
+ to be built successfully.
+ 7) Added a LFFS media driver (MEDLFS.PDD) to the WINS and Brutus platforms.
+ The WINS version emulates a media device by performing reads/writes to the
+ file <temp>LFSLDRV.BIN (e.g. C:\TEMP\LFSLDRV.BIN). The Brutus version uses
+ 2Mb of flash in Static Memory bank 1 and thus requires a pair of 1M x 16 flash
+ chips to be fitted to this bank. These devices aren't fitted on a standard Brutus
+ rack as shiped from Intel. The Brutus media driver is a read-only implementation
+ in this release.
+
+Version 1.02.180
+================
+(Made by Pete, 29th April 1999)
+
+ This is an ER5U release
+
+1) Jonathan
+ 1) Fixed EDN430762 (E32TEST T_REG.EXE fails in WINS REL).
+ TTrapK::Trap() in kpwins\kp_utl.cpp mixed assembler and C++ and was
+ being broken by MSVC5's aggressive optimisations when built for
+ WINS/WINC REL/UREL. The fixed code is still vulnerable to compiler
+ changes because it still contains one C++ statement and could
+ therefore be confused by the compiler setting up a stack frame or
+ trashing the cx register.
+ TTrap::Trap() in upwins\up_trp.cpp and upmx86\up_trp.cpp would contain
+ the same problem but we can't build the user library under MSVC5 with
+ optimisations enabled for other reasons so the problem does not
+ appear.
+
+2) Pete
+ 1) Modifications to Brutus variant (VISABA) to fix a problem with the PC Card
+ interface CD signals on GPIO7 (socket1) and GPIO4 (socket0). These were being
+ reconfigured to their alternate function (upper port of LCD interface) within
+ the function Variant::DisplayOn().
+ 2) Change to the way the ISA PC Card Controller handles a media change interrupt so
+ that it now queues a 20ms millisecond callback to handle switch debounce rather
+ than doing this directly from the interrupt service routine.
+ 3) In the ISA PC Card Controller abstraction, removed some redundant functions calls
+ called during media change and socket interrupt handling. These functions had been
+ carried over from the MARM platform.
+ 4) Disabled idle mode for now in the ISA platform (ImpHal::Idle()). There appears to be a
+ problem with PC Card IREQ interrupts (implemnted using GPIO edge triggered interrupt)
+ bringing the machine out of idle such that the machine eventually hangs.
+ 5) Implemented a new Pc Card Controller to Variant interface for ISA platforms (TPcCardControllerIsaInterface
+ in V32PCCDI.H). This includes the following new functions:-
+ - const TDesC8& SocketIntSource(TSocket aSocket,TPccdEvent anEvent);
+ - void InitSocketInt(TSocket aSocket,TPccdEvent anEvent);
+ - void ClearSocketInt(TSocket aSocket,TPccdEvent anEvent);
+ This is allows the socket interrupt implementation on ISA platforms to performed
+ at the variant layer
+
+3) Alex
+ 1) Modifications to ISA bootstrap (which is really tailored for the reference Brutus
+ platform) to support running code from RAM rather than FLASH. This means that images larger
+ than 4Mb (the previous limit on this platform due to the size of the flash bank) can be
+ handled. Use with E32UTILS REPROB V027.
+
+4) Pete
+ (inc\E32SVR.H)
+ Modification to TLocalDriveCapsV2 to add the data member
+ iEraseBlockSize. This is to support an F32 Flash File System.
+
+
+Version 1.02.166
+================
+(Made by Jonathan, 23rd February 1999)
+
+1) Jason
+ 1) Implemented Millisecond timer for MISA.
+ 2) Made the ATA Media driver as part of the ROM for MISA.
+
+2) Dennis
+ 1) Replaced Snowdrop digitiser default calibration values with values
+ supplied by Amazon.
+ 2) Modified Windermere LCD controller Timing2 register setting as
+ requested by Amazon.
+ 3) Changed Snowdrop current consumption and battery threshold values
+ to those supplied by Amazon.
+
+3) Morgan
+ 1) Replaced the code that stops the machine turning off if an absolute
+ timer is due soon.
+
+4) Jonathan & Co
+ 1) Boilerplated source.
+ 2) Removed historical epocfns.txt, sizes.txt, sizes.xls from .\group.
+
+5) Alastair
+ 1) Replaced hard-coded R: with %s% in MNT.BAT.
+ 2) Changed MNT PUTSRC to use T:\Tools\Zip.exe rather than
+ T:\Tools\PKZip.exe.
+ 3) Changed MNT GETREL to get the WINC debugging releaseables for DEB and
+ UDEB builds.
+ 4) Removed non-existent V32ARMS1.H, V32SASIC.H and duplicate listing of
+ K32POWER.H from \E32\INC\INCK.PRJ.
+ 5) Removed non-existent D32FTIM.H, D32FTIM.INL and *.FRZ from
+ \E32\INC\INCC.PRJ.
+ 6) Added CONSWINS.DEF, CONSMARM.DEF and CONSMISA.DEF to \E32\INC\INCK.PRJ.
+ 7) Removed CAKDP2 Series5 keyboard variants from EMARM.REL.
+ 8) Removed ELOCL variants from EMARM.REL, EWINS.REL and EWINC.REL.
+ 9) Moved \E32\INC\INCC.PRJ to \E32\GROUP\INCC.REL and \E32\INC\INCK.PRJ to
+ \E32\GROUP\INCK.REL and changed MNT.BAT so that these .REL files are
+ treated in the same way as all the other .REL files.
+ 10) Updated validation process to use William's new EVALID.BAT (added to
+ E32\Group pro tem.).
+ 11) Removed empty file \E32\Inc\M32hal.inl.
+
+
+Version 1.02.165
+================
+(Made by Pete, 16th February 1999)
+
+1) Jason
+ 1) Removed fixed Rom address from MMU initialisation bootstrap code.
+
+2) Morgan
+ 1) Fix for defect EDN964446 to prevent WINS standby going re-entrant.
+
+3) Mark
+ 1) Implemented PC card driver for MISA.
+
+4) Dennis
+ 1) Applied Jason Robinson's patch for defect EDN061952 (cannot force a
+ cold reset by holding down both shift keys).
+ 2) Fixed problem EDN106813 (snowdrop pathological failure mode).
+
+5) Pete
+ 1) Added range checking to the Pc Card h/w chunk allocation functions
+ (derived versions of RPccdChunkBase::CreateL()) in MARM, MISA and MAWD
+ builds to prevent this allocating memory chunks beyond the physical
+ region assigned to the Pc Card memory.
+
+
+Version 1.02.164
+================
+(Made by Jonathan, 10th February 1999)
+
+1) Jonathan
+ 1) Disabled the crash debug monitor.
+ 2) Fixed problem EDN941329 "RThread::GetRamSizes() Crashes the Kernel" by
+ making RThread::GetRamSizes() return 0 for the heap size in combined
+ stack+heap chunks.
+ 3) Applied Dennis' fix for EDN157244 "Process creation can leak memory"
+ by promoting DPlatProcess::FirstThread() to DProcess::FirstThread()
+ and checking for case where OOM occurs after thread creation.
+
+2) Dennis
+ 1) Fixed problem EDN256123 (adding a thread to a dead process crashes the
+ kernel). Create empty process handles array after deleting the
+ original one, and when creating a new thread check that the owning
+ process is not dead.
+ 2) COM061952: Put in Jason Robinson's bootstrap fix for Windermere so
+ that cold resets (both shift keys down) should now work on Snowdrop.
+
+3) Morgan
+ 1) User::LoadLogicalDevice and User::LoadPhysicalDevice now supply
+ match-Uid's KLogicalDeviceDriverUid and KPhysicalDeviceDriverUid on
+ their calls to RLoader::LoadLibrary
+
+4) Pete
+ 1) Added the function TPBusCallBack::Clear() (exported from EPBUS.DLL) to
+ clear the source of a Peripheral Bus event (e.g. IREQ interrupt from
+ PC card). This is a 'generic' version of the temporary fix applied in
+ E32-162 for defect 'CF Card interrupts being missed on Snowdrop
+ machines'. Also, removed the functions
+ DPcCardController::EnableEvent() and DPcCardController::DisableEvent()
+ and replaced them with TPBusCallBack::Enable() and
+ TPBusCallBack::Disable() respectively.
+ 2) Added the functions DPcCardController::PwrUpProfile() and
+ DPcCardController::SetPwrUpProfile() to read/modify the power up
+ profile of the PC Card Controller (ie time reset applied, pause after
+ card becomes ready, timeout period when waiting for card to become
+ ready). Removed the parameter 'aResetProfile' from
+ DPeriphBusController::PowerUpBus(), DPcCardController::PowerUpCard(),
+ and DPcCardController::RestoreCardPower() as this information is now
+ superfluous.
+ 3) Increased synchronous busy timeout period on ARM ATA driver from 15mS
+ to 20mS to support large Lexar CF cards.
+ 4) Enabled CF card rail (Vpc) monitoring in Snowdrop variant. Also
+ modified this so that checking is performed periodically as long as
+ the rail is on (in addition to once when first turned).
+ 5) Change to ARM ATA driver so it checks for 'card not busy' if it times
+ out on a command. If the card isn't busy then it processes this as if
+ it had received a normal card interrupt.
+
+
+Version 1.02.163
+================
+(Made by Pete, 3rd February 1999)
+
+1) Morgan
+ 1) Fixed a problem that was causing Dll entrypoints to be called
+ with EDllProcessAttach twice.
+
+2) Jason
+ 1) Restored the RAM drive to MISA.
+
+3) Dennis
+ 1) Fixed problem EDN591058 (remote thread write to end of chunk can
+ fail). Use sizeof(TDes8) instead of sizeof(TBuf8<1>)-1 for checking
+ to avoid alignment problems.
+ 2) Fixed problem EDN468376 (RHeap::Compress can leave heap
+ corrupted). In the situations where a free cell header would have
+ been chopped in half, an extra page of RAM is now left allocated to
+ the heap.
+ 3) Fixed problem EDN102617 (undefined instruction exception kills the
+ kernel). Modified undefined instruction handler to run Exc::Dispatch
+ in mode_und rather than mode_abt.
+ 4) Modified super page signature so that it includes the E32 version
+ number. This means that when a machine is reprogrammed to a
+ different version of E32, a cold reset will be forced when the
+ machine is first booted even if the user attempts to do a warm
+ reset.
+
+4) Jonathan
+ 1) Fixed problem EDN671244 (RDebug::ReadMemory can reset the machine)
+ by trapping calls from Debug::DebugFunction to Debug::ReadMemory and
+ Debug::WriteMemory.
+ 2) Fixed problem EDN471656 (underlying cause of which was RAM disk
+ size not being a multiple of page size) by applying Andrew/Pete's
+ modified fix.
+
+5) Pete
+ 1) Renamed current implementation of the class TLocalDrive as
+ TBusLocalDrive. Also, changed TBusLocalDrive::Caps() from the form:-
+ TInt Caps(TLocalDriveCaps &anInfo);
+ to
+ TInt Caps(TDes8& anInfo);
+ with the later taking a TLocalDriveCapsBuf.
+ Re-introduced a TLocalDrive class which is BC with the E32-114
+ version. The TLocalDrive class will be maintained to support disk
+ utilities which need a level of direct disk access. However,
+ TLocalDrive functions: Enlarge(), ReduceSize() and Format() now
+ return KErrNotSupported. TBusLocalDrive is intended to be used only
+ by F32 and there is no BC commitment with this. (Fixes EDN545357).
+ 2) Added EPBUS.MAP to MARM,MISA,MAWD release files.
+ 3) Modification to prevent CF card from being powered down during a
+ write operation when the machine is turned off. This involves a
+ change to DPcCardController::PowerStandby() so that it waits a short
+ period for any critical operation to complete. If still critical
+ after that period then it goes ahead and powers down the sockets,
+ but generates an emergency reset event so that clients can attempt to
+ recover. (Fixes EDN201114).
+ 4) Modification to IRAM media driver (EPOC Platform) so that when it is
+ first mounted, it takes its initial size directly from the super
+ page rather than the IRAM chunk size (which is in multiples of a
+ page size).
+
+
+Version 1.02.162
+================
+(Made by Morgan, 27th January 1999)
+
+1) Dennis
+ 1) Fixed problem EDN153887 (using infra-red lowers RS232 RTS line) -
+ modified VAWDB1\VA_COM1.CPP to ensure that UART1 SIR enable bit is
+ always cleared.
+ 2) Store garbage values in K::SvThread and K::SvProcess on completion of
+ a kernel server function to guard against inadvertent use of these in
+ executive calls or DFCs.
+ 3) Fixed problem EDN741588. Modified S::ChunkCompressAll() in KS_CHK.CPP
+ so that it only attempts to compress the kernel heap if its critical
+ section is not blocked.
+ 4) Added extra command 'R' to crash debugger to print the values of all
+ processor registers across all processor modes at the point where the
+ debugger was entered.
+
+2) Jason
+ 1) Restored link to MISA Idle code with-in the bootstrap.
+ 2) MISA DRAM initialisation made to match the documentation.
+
+3) Jonathan
+ 1) Added missing "Distribution:" comments to PSRC\LI.PRJ and
+ KBAWD\LI.PRJ. Modified "mnt check" to check that all LI.PRJs contain
+ "Distribution:" comments.
+ 2) Added new "mnt distrib" verb for zipping up a copy of E32 source for
+ distribution to a named licensee. This verb is intended to be used
+ on a clean freshly-got copy of the source.
+ "mnt distrib acme" will produce \E32-acme.zip for acme.
+ "mnt distrib generic" will produce an unencumbered \E32-generic.zip.
+
+4) Pete
+ 1) Fixed EDN590829 (CF Card interrupts being missed on snowdrop
+ machines). Fixed by clearing the interrupt directly from the media
+ driver interrupt callback rather than relying on it to be cleared by
+ the PC Card controller before the callback. This affects CF cards
+ which 'claim' to support pulse mode interrupts but actually seem to
+ implement level mode interrupts.
+
+
+Version 1.02.161
+================
+(Made by MarkD, 19 January 1999)
+
+1) Dennis
+ 1) New Snowdrop digitiser and SPI code from Mark Ball.
+ 2) Battery low interrupt now disables UART and Codec interrupts on
+ EIGER to prevent watchdog death due to permanently asserted
+ interrupt from UART when power is removed abruptly.
+ 3) Reinstated __COMMS_MACHINE_CODED__ in VA_COM1.CPP for P2 and PD
+ variants, after fixing problem caused by hard-coded vtable offset.
+
+2) Pete
+ 1) Fixed two problems with the ATA command timeout
+ implementation on the ARM ATA driver. (The timeout catches
+ situations where a request is made on the card which ought to be
+ signalled by an interrupt from the card when complete, but where the
+ card fails to generate an interrupt):-
+ a) Changed to use a ticklink rather than a
+ TMilliSecondCallBack to implement the timeout.
+ b) Fixed a problem where the timeout could be requeued
+ before the previous timeout had completed.
+ 2) Increased synchronous busy timeout period on ARM ATA driver from
+ 8mS to 15mS to support KingMax CF cards.
+ 3) Modification to function DMediaDriver::RequestSetup()
+ so it now returns KErrInUse if the data member iReqStat isn't NULL.
+ This prevents the possibility of more than one request at a time on a
+ single media driver.
+ 4) Stopped releasing WINS .BMP files (ie killed SWINS.REL).
+
+3) Morgan
+ 1) Turned off emulation of the WINS backlight
+
+
+Version 1.02.160
+================
+(Made by Jason, 12th January 1999)
+
+1) Mark
+ 1) Fixed a problem with MISA such that the screen wasn't being turned
+ on.
+
+2) Dennis
+ 1) Added kernel crash debugger to MARM and MAWD builds. When a kernel
+ fault occurs, the debugger will start instead of the machine just
+ restarting. The crash debugger is enabled by compiling with
+ __ENABLE_DEBUG_MONITOR__ defined in M32STD.H.
+ 2) Got the C++ build going again. Compiling with
+ __MINIMUM_MACHINE_CODE__ defined in U32STD.H will result in a build
+ with all non-essential machine code removed. All tests pass on EIGER
+ in debug and release builds.
+ 3) Assembler-coded most TWind functions (KE_WIND.CPP).
+ 4) Made RPointerArray<T>::Count() and RPointerArray<T>::Find*() const.
+ 5) Added check in svProcessTerminate in KS_SVR.CPP so that calling
+ RProcess().Terminate() does not crash the kernel.
+
+3) Jason
+ 1 ) MISA five layer split done created \e32\kaisa\ removed \e32\keisa\.
+
+4) Morgan
+ 1) Added Dll::FileName() which will return the drive, path, and filename
+ of the library it is called from. (Added UserSvr::DllFileName and
+ associated EXEC functions to support this). Dll's that exist on the
+ ROM drive and have not been RLibrary::Load()ed will return only the
+ drive, (ie. "Z:").
+ 2) Fixed bugs in LoadLogicalDevice and LoadPhysicalDevice that was causing
+ unbalanced calls to the entrypoint of drivers (with EProcessDetatch and
+ EThreadAttach).
+ 3) Removed cleanup code from user side code RLoader::LoadLibrary. Cleanup
+ of half loaded dll's is now performed loader side as it should be.
+ 4) Fixed a problem with switch-off-on-case-close.
+ 5) S::LoadLibraryExact now creates a handle into the Loader thread rather
+ than into the loading client. DLibrary::LoadedL transfers handles and
+ created dependencies as required. See Note F32 126.2.2
+
+
+Version 1.02.159
+================
+(Made by Pete, 21st December 1998)
+
+THIS RELEASE OF E32 REQUIRES F32 125
+
+1) Jonathan
+ 1) Added TLanguage enums { ELangTaiwanChinese, ELangHongKongChinese,
+ ELangPrcChinese, ELangJapanese, ELangThai }.
+
+2) Morgan
+ 1) Removed old static power functions that are no longer used from
+ classes P, K, and ImpPsu.
+ 2) Removed TKeyboard::SwitchOn() and TXYInput::SwitchOn(). And for those
+ variants that required it, upgraded the keyboards and digitisers to be
+ first class power handlers.
+ 3) Changed KLogicalDeviceDriverUid for Unicode and Narrow builds because
+ the Ldd interface has changed. This change stops old device drivers
+ loading on the new kernel.
+ 4) Uniquely identified each architecture of the kernel with a Uid. This
+ change stops libraries that link to the kernel from loading on the
+ wrong architecture.
+
+3) MarkD
+ 1) Performed the PC Card reorganisation for MISA.
+ 2) Fixed a problem in KEISA\KE_INI where the requested video chunk size wasn't
+ rounded to page size.
+ 3) Added a serial driver for Brutus using serial ports 1 (VISABA\VI_COM1.CPP)
+ and 3 (VISABA\VI_COM2.CPP).
+
+4) Alastair
+ 1) Fixed ER5 defect EDN381842 "WINS 'large' fascia problem under Win95/98".
+ If not running under Windows_NT SetupEmulatorPaths() function in upwins\up_path.cpp
+ takes account of the fact that Win32 GetModuleFileName() will report a full path
+ rather than a virtual path if the Emulator is running on a subst'ed drive from a
+ DOS prompt.
+
+5) Petteri
+ 1) Changes to VARMCL variant to fully enable the PC Card Controller. All PC Card tests
+ now pass on this variant.
+
+6) Dennis
+ 1) Merged in more Amazon changes to Windermere port.
+ 2) Modified Plat::ScreenInfo for Windermere to return the address of the screen RAM
+ bitmap rather than the palette.
+ 3) Fixed a bug in the text window server introduced in 158 which stops pointer drag
+ from working.
+
+7) Pete
+ 1) Various changes to facilitates a better partitiioning of
+ functions between EKERN and EPBUS and to allow ROMS to be built without an EPBUS
+ component. Functions which previously called either TPBusCallBack or
+ Kern::PBusController() in the indepedant layer have now been moved to the Asic
+ layer:-
+ Modification of class DPrimaryMedia into an Indepedent layer class
+ DPrimaryMediaBase and a Asic layer class DPrimaryMedia.
+ Modification of class DMediaChangeNotifier into an Indepedent layer class
+ DMediaChangeNotifierBase and a Asic layer class DPrimaryMedia.
+ Functions K::PowerUpPeriphBus(), K::BusDevPowerStatus() are now platform
+ dependent (hence moved to class P). Also creation of the functions P::ForceMediaRemount(),
+ ImpHal::TotalSupportedBuses() and ImpHal::TotalSupportedDrives().
+
+Version 1.02.158
+================
+(Made by Pete, 7th December 1998)
+
+1) Morgan
+ 1) Bug fix for MARM and MAWD Emergency power down. (Screen not powered up
+ after emergency power down). Effects KEAWD\KE_POWER.CPP and
+ KAEIG\KA_POWER.CPP
+ 2) Pointer-switch-on now behaves as it did in E32(156).
+ 3) Added MISA power model.
+
+2) Pete
+ 1) Split out the PC Card Controller from the kernel into a new
+ component - EPBUS.DLL. The independant layer code, previously in \KSRC,
+ files KS_PCCD.CPP and KS_PSOCK.CPP has been moved into \PSRC.
+ The architecture layer code files have been renamed from K?_PCCD.CPP
+ to P?_PCCD.CPP (e.g. \KAEIG\KA_PCCD.CPP renamed PA_PCCD.CPP).
+ As far as the interface with the kernel is conserned, EPBUS.DLL
+ is now a 'generic' Peripheral Bus Controller rather than specifically a
+ PC Card Controller. Machines which have a MultiMedia card interface or
+ a USB interface rather than a PC Card interface will have a Peripheral
+ Bus Controller supplying services for these interfaces instead. This has
+ involved quite extensive modifications to the classes which previously
+ implemented the PC Card media change (DMediaChange) and supply voltage
+ (TPcCardVcc) since large parts of these implementations are common for
+ any Peripheral Bus Controller.
+ The classes associated with the 'generic' Peripheral Bus Controller
+ are defined in P32STD.H. Of these functions, the code for those asociated with
+ media change and supply voltage classes is in PS_PSU.CPP and the code for the
+ Controller interface itself is in PS_PBUS.CPP. The independant layer code for
+ the PC Card Controller implementation in now in PS_PCCD.CPP and PS_PSOCK.CPP
+ (defined in P32PCCD.H).
+ The variant layer code for the Peripheral Bus Controller is still supplied
+ by the variant DLL. However, the bulk of the PC Card Controller functions have
+ been removed from the main Custom class and moved to a TPcCardControllerInterface
+ class (defined in V32PCCD.H). The custom now has a single function:-
+ TAny* Custom::CreatePeriphBusControllerInterface()
+ which returns a pointer to this class. This will allow variant layer code for other
+ types of Peripheral Bus Controller to be supplied by the variant DLL without bloating
+ the basic Custom class with these functions.
+ Removed the majority of the exported functions of the class UserPcCardController
+ (all apart from PwrDown() and NotifyChange()) from EUSER.DLL. Also, constructors for the
+ classes TPccdChnk, TPccdConfigInfo, TPccdRegionInfo and TPccdType. The DEF file entries for
+ these functions have been replaced with NotSupported entries.
+ Similarly, fixed up the MARM/WINS EKERN DEF files to replace all the entries for
+ exported PC Card Controller functions with NotSupported entries.
+ [Note: No Pc Card reorganisation for MISA.]
+ 2) The class TPccdCallback has become TPBusCallBack. A single callback can now be
+ registed for mutiple events, with the event now specified by a mask rather than an enum.
+ This has simplified the implemenation of the classes DPrimaryMedia and DMediaChangeNotifier.
+ 3) Modified the variant function PcCardMemPhysicalAddress() to take an extra
+ parameter - 'TPccdMemType'. Prior to this, the variant just returned
+ the physical address per socket, with the kernel adding an offset
+ dependant on the memory type. Unfortunatley, the PS7111 has a
+ different PC Card memory offset scheme to that used in the PS7110.
+ Hence the need for it to be calculated in the variant (since 7111 and
+ 7110 share the same kernel).
+
+
+Version 1.02.157
+================
+(Made by Dennis, 1st December 1998)
+
+NOTE: Must be used with F32 version.
+ No ISA or Windermere binaries.
+ Outstanding problem with machine-code serial PDDs (non-machine code
+ version has been released) and with Windermere power-off.
+ Bldmake-generated batch files are no longer released as source so
+ bldmake <all> must be run to create the batch files before any building
+ can be done.
+
+1) Morgan
+ 1) Added uid-type-safety overloads to RLibrary::Load() and
+ RProcess::Create() to only load Dlls and Exes that match
+ the supplied Uids.
+ eg
+ lib.Load(_L("\\system\\plugins\\PLUGIN.DLL");
+ should change to
+ lib.Load(_L("\\system\plugins\\PLUGIN.DLL"),
+ TUidType(KNullUid, KPluginUid, KNullUid);
+ where KPluginUid is either KPluginUid8 or KPluginUid16.
+ 2) SARMBE-RIP
+ 3) Added a new power management framework in INC\K32POWER.H. Here is a
+ quick overview:
+ A DPowerHandler performs power related functions previously resident
+ in DLogicalChannel, and also provides mechanisms for communicating
+ with the machine's power model. A DPowerModel, (DEigerPowerModel on
+ the Series5, DWinsPowerModel on WINS), logs all DPowerHandlers in
+ the system and their power requirements. The power model controls
+ power up and power down behaviour of all shared power units. This
+ allows it to dictate the machine's power management policy. (See
+ document POWER001 in the Base database for more grusome details).
+ These changes break binary compatability for DLogicalChannels, and
+ existing device drivers that require power management.
+
+ * Here is some guidance on how to update existing
+ DLogicalChannels to use E32(157):
+ // 1. given an old Ldd "Tomfoolery":
+ class DTomfooleryLdd : public DLogicalChannel
+ {
+ public:
+ ~DTomfooleryLdd();
+ [...]
+ // override DLogicalChannel pure virtual functions
+ virtual void DoPowerUp();
+ virtual void DPowerDown();
+ virtual void DoEmergencyPowerDown();
+ }
+
+ // 2. modify the class declaration to insert a power handler
+ class DTomfooleryPowerHandler;
+ class DTomfooleryLdd : public DLogicalChannel
+ {
+ public:
+ ~DTomfooleryLdd();
+ [...]
+ // these power functions no longer need to be virtual
+ // but you may wish to keep them virtual to maintain
+ // Ldd-Pdd compatability.
+ virtual void DoPowerUp();
+ virtual void DoPowerDown();
+ virtual void DoEmergencyPowerDown();
+ public:
+ // add power handling to this channel
+ DTomfooleryPowerHandler *iPowerHandler;
+ }
+
+ // 3. add a new power handler to the TOMFOOL.CPP file
+ class DTomfooleryPowerHandler : public DPowerHandler
+ {
+ public:
+ DTomfooleryPowerHandler(DTomfooleryLdd *aLdd) : iLdd(aLdd) {}
+ virtual TInt DoPowerOn() { return iLdd->DoPowerUp; }
+ virtual void DoPowerStandby() { iLdd->DoPowerDown(); }
+ virtual void DoPowerRestart() { iLdd->DoPowerDown(); }
+ virtual void DoPowerEmergencyStandby() { iLdd->DoEmergencyStandby(); }
+ public:
+ DTomfooleryLdd *aLdd;
+ }
+
+ // 4. change DTomfooleryLdd::DoCreateL and destructor
+ void DTomfooleryLdd::DoCreateL(...)
+ {
+ [...]
+ iPowerHandler=new (ELeave) DTomfooleryPowerHandler(this);
+ // register the power handler so we get power events
+ User::LeaveIfError(Power::AddPowerHandler(iPowerHandler));
+ [...]
+ // ask the PowerManager to power us up
+ iPowerHandler->PowerOn();
+ }
+ DTomfooleryLdd::~DTomfooleryLdd()
+ {
+ [...]
+ // ask the PowerManager to power us down
+ iPowerHandler->PowerStandby();
+ // remove the power handler from the system
+ Power::RemovePowerHandler(iPowerHandler);
+ delete iPowerHandler;
+ }
+
+ // 5. Finally, redirect calls to DLogicalChannel::PowerGood()
+ // and SetPowerConsumption() through the new iPowerHandler and
+ // remove all references of RegisterEmergencyPowerDownHandlerL()
+
+ It should also be noted that DLogicalChannel::PowerOn() and
+ DLogicalChannel::PowerDown() are no longer called called during
+ S::CreateLogicalChannel() and DLogicalChannel::Close().
+ 4) Moved WINS, MAWD and MARM over to the new power models. Changed
+ DPcCardCntrl, and DLddSound to use the new facilities.
+ Also Altered DComm, DChannelComm, and DEigerComm.
+ [Note: Models not added for MMAD, MISA.]
+ 5) Removed duplicate implementations of P::PowerOff, P::PowerOn,
+ P::Standby(), and P::CheckSupplies in WINS.
+
+2) Jo
+ 1) Fixed EPOC software problem SW1-266 "TLocale isn't updated in
+ WINC/WINS when the time zone is changed"
+ Added a line to KPWINS\KP_INI to update locale data on EStartupCold
+ when the time zone on the PC is changed.
+
+3) Jane
+ 1) Split kearm directory into kcarm for cpu only code and kaeig for
+ asic code.
+ Made the kcarm code generic for any arm processor, so that all arm
+ based ports can eventually share it.
+ Added a set of __CPU_ #defines for "cpu properties" such as whether
+ cache is write-back or write-through, whether there is a write
+ buffer, and so forth. Used these to make the kcarm directory
+ generic.
+ These properties are set up in u32std.h from the build #define.
+ Moved the MAD port to the new scheme - it shares the kcarm directory
+ and has its own asic dependent directory, kamad.
+ The MARM and MAD ports have new .MMP files for ekern (ekernx),
+ ekdata (ekdatx) and ke_exe (kc_exe).
+ I am particularly pleased with the new TMadPanic - it made it all
+ worthwhile...
+
+4) Alastair
+ 1) Changed PP::TheMachineName to "Epoc". Take note SDK people, this
+ means the default .INI file loaded from the emulator's data
+ directory will be EPOC.INI rather than SYSTEM.INI. I've also
+ removed the facility to specify the fascia bitmap within the
+ <machine>.ini file - instead the emulator will expect the fascia
+ bitmap to have the same base name as it's corresponding ini file -
+ so if the emulator is invoked with the -Mgeofox1 switch it will try
+ to load geofox1.bmp. By default the emulator will try to load
+ epoc.bmp. I've updated E32's SWINS release component accordingly.
+ 2) Updated EKERN.MMP and EUSER.MMP to take advantage of MAKMAKE's new
+ FIRSTOBJECT keyword (E32TOOLP 097). Merged Jane's new EKERNX.MMP
+ into EKERN.MMP, and old KE_EXE.MMP into Jane's new KC_EXE.MMP
+ following these changes.
+ 3) Exporting the following functions from ekern under WINS/WINC by
+ ordinal rather than name
+ EXPORTS E32KernelDispatchAddress @279 NONAME
+ EXPORTS _E32Initialise @280 NONAME
+ EXPORTS _E32DeInitialise @281 NONAME
+ EXPORTS _E32ExitProcess @282 NONAME
+
+ Euser.dll has been changed to look up these functions by ordinal.
+ The latter 3 functions were previously only exported under WINC, and
+ do nothing and are not called under WINS. The hack in MAKMAKE to
+ handle the linking of these functions by ordinal has been removed
+ (E32TOOLP O97).
+ 4) Removed Plat::EnterCS() and Plat::LeaveCS() from ESDRV.CPP and
+ ECDRV.CPP
+ - these fixes should no longer be required to avoid deadlock since a
+ generic fix has been applied to E32 version 155.
+ 5) Added 2 new exports to EUSER.DLL in E32WINS.H
+ IMPORT_C void SetEmulatorColorDepth(TUint& aDepths);
+ IMPORT_C void EmulatorColorDepth(TUint& aDepths);
+ SetEmulatorColorDepth() is called by EKERN.DLL which will set colour
+ depths supported by the emulator according to the specification of
+ the ColorDepth keyword in the System.ini file. Syntax is
+ ColorDepth {Gray2} {Gray4} {Gray16} {Color16} {Color256}
+ {Color4K} {Color16M}
+ If the ColorDepth keyword is not specified supported colour depths
+ will default to Gray2,Gray4 and Gray16 for backward compatibility.
+ Users of EmulatorColorDepth() will need to pass a bitmap reference
+ to the function which will be set based on the following constants
+ defined in E32WINS.H
+ const TUint KEmulGray2= 0x00000001;
+ const TUint KEmulGray4= 0x00000002;
+ const TUint KEmulGray16= 0x00000004;
+ const TUint KEmulGray256= 0x00000008;
+ const TUint KEmulColor16= 0x00000010;
+ const TUint KEmulColor256= 0x00000020;
+ const TUint KEmulColor4K= 0x00000040;
+ const TUint KEmulColor64K= 0x00000080;
+ const TUint KEmulColor16M= 0x00000100;
+ 6) Changed RThread::Panic() so that in WINS DEBUG builds it calls a new
+ function, ThreadPanicBreakpoint2, in upwins\up_debug.cpp, with
+ information about the thread being panicked and also the name of the
+ killing thread. This fixes Epoc S/W problem 356 "The __DEBUGGER
+ macro that catches panics should be un-commented out." To get the
+ Windows ID of the panicking thread in RThread::Panic() I changed the
+ code which keeps a list of Epoc threads in EUSER.DLL so that it
+ contains the Epoc thread ID as well as the Windows one and added a
+ function to upwins\up_thrd.cpp, TUint32 WinsEpocThreadWinID(TUint
+ aEpocID), which returns the Windows ID corresponding to the Epoc ID
+ passed in as a parameter.
+ 7) Split header inc\e32wins.h into 2 headers, e32wins.h and u32wins.h.
+ U32wins.h contains euser functions that should not need to be used
+ by any component except E32.
+ 8) Removed all the logical and physical device driver deffiles from
+ \E32\INC, since makmake always ensures the right function is
+ exported at ordinal one for LDD and PDD targettypes.
+ 9) Changed the Emulator's path scheme. Now, if a directory called
+ 'Data\' is found in the same directory as the executable which
+ started the Emulator, the Emulator's data directory will be
+ considered to be this directory and expected to contain .INI files
+ and any corresponding bitmaps. Also, directories 'C\' and 'Z\' in
+ the executable's directory will be mapped to the emulated C: and Z:
+ drives. If a 'Data\' directory is not found in the executable's
+ directory, the old scheme will be assumed where the Emulator's data
+ directory is '\Epoc32\Data\' and the emulated C: drive is mapped to
+ 'Epoc32\WINS\C\'.
+ 10) Fixed Epoc S/W problem 466
+ "Plat: 46 fault when running EXEs from a different directory".
+ The emulator now looks in the directory containing the emulated Z
+ directory for filenames specified without a drive, rather than in
+ the directory containing the executable that started up the
+ emulator; so if Z is mapped to \Epoc32\Release\WINS\DEB\Z\, the
+ emulator will look in \Epoc32\Release\WINS\DEB\ for these files.
+ Note that mappings for emulated C and Z drives will be overwritten
+ if specified in the environment, but can safely be set in the
+ EPOC.INI file using the _EPOC_DRIVE_? keyword. Any attempted
+ mapping for the Z drive which does not specify a directory ending in
+ \Z or \Z\ will fail.
+ 11) Removed references to all bldmake-generated batch files from LI.PRJ
+ files containing them, and updated MNT.BAT so that directories \BWINC,
+ \BVC4 and \BVC4WINC are not archived (they contain nothing but
+ bldmake-generated files anyway). This means that to build E32 from
+ source bldmake must always be called first to generate the batch files,
+ and ensures these batch files are more likely to be up-to-date.
+
+5) Jonathan
+ 1) Retired KEARM directory following Jane's changes. The MAWD and MISA
+ builds depended on some files in KEARM, so these files were copied:
+ KEISA: ke_edbg.cpp, ke_edbg.h, ke_dma.cpp
+ KEAWD: ke_edbg.cpp, ke_edbg.h, ke_dma.cpp,
+ ke_exc.cpp, ke_thrd.cpp,
+ ke_exe.cpp, ke_kdata.cpp
+ 2) Updated MNT.BAT to reflect all of the above directory changes.
+ 3) Hacked a workaround to MSVC++ 5.0 (sp3) assembler bug, where MSVC
+ incorrectly fixes up conditional jumps when the destination is a C++
+ function. Files affected: upwins\up_realx.cpp, upwins\up_i64.cpp.
+
+6) Dennis
+ 1) Fixed bug in serial comms driver relating to zero-length reads. If
+ the receive buffer was empty when a zero-length read was requested,
+ the driver would enter an inconsistent state and the request would
+ not be completed unless a terminating character was specified.
+
+7) Pete
+ 1) Added the class RBusDevCom which is intended as a replacement
+ for RDevCom (although the latter is still supported). This new class
+ allows the support of serial devices such as PC Card modems which
+ require the asynchronous power up of the card. The changes included
+ in E32-120 allowed these types of cards to be initially powered up
+ just before a channel was opened on the device. They didn't however
+ support the repowering of an open channel (which again needs to be
+ asynchronous) after the machine has been turned off. The RBusDevCom
+ now provides the means to support for this scenario. If a channel is
+ opened on a serial device which requires asynchronous powering then
+ all DoControl() and DoRequest() calls are preceded by a fast exec
+ call to check whether the device needs repowering. (Channels open on
+ standard serial devices don't suffer the penatly of this
+ exec. call).
+ Added the class RBusLogicalChannel (RBusDevCom is derived from
+ this class) which is intended as a replacement for RLogicalChannel -
+ to be used for devices which may need to be asynchronously powered
+ either before opening or while the channel is use. RLogicalChannel
+ would continue to be the choice for classes of devices which don't
+ require this behaviour.
+ Modifications to the TLocalDrive class. This now makes use of the
+ MBusDev class - created as part of the implementation of the
+ RBusLogicalChannel class.
+ Fixed a problem with the TLocalDrive class CheckMount() function
+ so that it can't lock the file system doing continuous re-mounts
+ when a CF card is inserted that never asserts its RDY signal.
+ 2) Added a member 'iHiddenSectors' to TLocalDriveCaps
+ to report the number of sectors on a media device reserved before
+ the start of the first partition.
+ 3) Added a new version of the
+ DPcCardCntrl::RegisterEvent() function taking an extra parameter
+ 'TUint aFlag'. This allows the better support of PC cards which use
+ level mode interrupt requests rather than pulse mode. The flag is
+ set when level mode is required meaning the PC Card Controller can
+ avoid failing to clear the interrupt in the PC Card Controller
+ hardware.
+ 4) Merged various changes to the MAWD architecture layer, the MAWD
+ B1 variant layer and the MARM P2 variant layer including a new SPI
+ implementation for MAWD, support for ETNA Rev3 etc.
+ Added a function Plat::WaitAtLeastAMicroSecond() for use by the
+ ATA media driver.
+
+
+Version 1.02.156
+================
+(Made by Jonathan, 27th October 1998)
+
+N.B. WINS DEB/UDEB will only work with F32 122 OR LATER.
+
+1) Dennis
+ 1) Reintroduced debug/release interoperability for WINS. Removed
+ CBase::iName and SObjectIxArray::iPadding. Deleted all debug DEF
+ files.
+ 2) Merged in Andrew Thoelke's E32 proposals:
+ i) SW1-77 Compiler-generated constant descriptors.
+ ii) SW1-14 C++ range-checking template wrapper for fixed arrays.
+ iii) SW1-87 CleanupClosePushL and related cleanup-stack things.
+ 3) Globally disabled warning about not inlining functions in MSVC++ 5.0.
+
+2) Jonathan
+ 1) Fixed version bug in mnt getbld.
+ 2) Fixed pvcs paramater error for bsarm and bsarmbe dirs in mnt *lock.
+
+3) Alastair
+ 1) Added the following Unicode Uid values
+ KLogicalDeviceDriverUidValue 0x100039cf
+ KPhysicalDeviceDriverUidValue 0x100039d0
+ KKernelUidValue 0x100039e2
+ KUserDllUidValue 0x100039e5
+ KLocaleDllUidValue 0x100039e6
+ KConsoleDllUidValue 0x100039e7
+ KDisplayDllUidValue 0x100039eb
+ KCustomDllUidValue 0x100039e8
+ KKeyboardDllUidValue 0x100039e9
+ KKeyboardDataUidValue 0x100039e0
+ KKeyboardTranUidValue 0x100039e1
+ KXYInputDllUidValue 0x100039ea
+
+ N.B. some of these values are defined in the file E32UID.IBY (from
+ \e32\kbarm\,\e32\kbisa\, etc). If this file is to be used in creating
+ UNICODE roms then the preprocessing stage prior to rombuilding should
+ define the _UNICODE macro.
+ 2) Updated .MMP files in accordance with the UNICODE plan.
+ 3) Changed MNT.BAT to get E32TOOLP version 096.
+
+
+Version 1.02.155
+================
+(Made by Morgan, 20th October 1998)
+
+NB: REQUIRES F32 VERSION 121 OR ABOVE, WSERV VERSION 100 OR ABOVE
+
+0) Jonathan
+ 1) Added Distribution lines to the LI.PRJ files in all subdirectories to
+ identify licensee-specific source.
+
+1) Graham Asher, 13/10/98
+ These changes affect the Unicode builds only. They make it possible to use
+ several different sets of collation rules in the same locale, which is
+ needed for East Asian locales; and they make it easier to write collation
+ rules for these and other locales.
+
+ \inc\collate.h
+ introduced TCollationRepertoire - stores a series of rule sets so that one
+ can choose, say, between sorting on stroke count and radical, or JIS code,
+ without changing locale. added new collation operators to make it easier
+ to write complex collation rules reorganised TCollate constructors to make
+ them easier for Mem functions to call
+
+ \inc\e32des16.h
+ added new TDesC16::CompareC overloads to allow selection of rule set
+
+ \inc\e32panic.h
+ added EBadCollationRulesIndex panic number
+
+ \inc\e32std,h
+ added Mem functions to enumerate collation rule sets and select them when
+ comparing; these are new CompareC overloads
+
+ \inc\u32std.h
+ changed LCharSet to include a collation repertoire (instead of just a ptr
+ to the rules) and a collation attribute repertoire
+ (TUnicodeAttributeRepertoire) for storing locale-specific character
+ attribute tables like radical and stroke count
+
+ \inc\unicode.h
+ added the new structures used by TCollationRepertoire, and added
+ TUnicodeAttributeRepertoire and its constituents; added
+ TUnicode::GetAttribute, so that collation can use locale-specific
+ attributes, and abolished TUnicode::TranslateFromUnicode and
+ TUnicode::TranslateToUnicode
+
+ \lsrc\ls_unic.cpp
+ now contains collation repertoire ptr, not rules ptr, and an attribute
+ repertoire ptr for any attributes supported by the locale
+
+ \ucdt\uc_des16.cpp
+ implementation of new TDesC16::CompareC overloads
+
+ \ucdt\uc_exec.cpp
+ TChar::TranslateFromUnicode and TChar::TranslateToUnicode now do nothing;
+ have not abolished them like the TUnicode functions of the same names
+ because of binary compatibility
+
+ \ucdt\uc_func.cpp
+ added new Mem functions to enumerate and retrieve collation rules; and
+ implemented new Mem::CompareC overloads
+
+ \unicode\collate.cpp
+ reorganised constructor arguments; implemented new operators including
+ those that retrieve locale-specific attributes; increased subkey size to
+ 16 bits
+
+ \unicode\unicode.cpp
+ abolished TUnicode::TranslateFromUnicode and TUnicode::TranslateToUnicode
+
+2) Dennis
+ 1) Machine coded most of the TEiger functions because things like keyboard
+ scanning were taking a ridiculously long time (nearly 500us).
+ 2) Fixed bug SW1-256 - TInt64::TInt64(TReal) won't compile under VC5.
+ 3) Fixed bug SW1-738 - Scheduler bug may leave processes unprotected.
+ 4) Added extra function calls to serial comms PDD VA_COM1.CPP to cope
+ with new chained interrupts.
+
+3) Alastair
+ 1) Changed Emulator title bar to read "EPOC Emulator".
+ 2) Changed \e32\dpwins\d_medint.cpp and \e32\kpwins\kp_pccd.cpp
+ to use Win32 function GetTempPath() to get the system
+ temporary path rather than manually checking the "temp" environmental
+ variable. Fixes Epoc Software problem SW1-112.
+ 3) Changed WINS F11 key case closed behaviour so that "case
+ closed" is added to the WINS title bar rather than the case
+ bitmap being displayed.
+ 4) Removed possibility of specifying the case bitmap within
+ WINS's system.ini file, and all references to the case bitmap.
+ 5) Disabled Emulator Window maximise button since the button
+ served no purpose.
+ 6) Added new header \E32\INC\E32WINS.H containing the following
+ WINS-specific functions to be exported from EUSER.DLL
+
+ IMPORT_C TInt SetupEmulatorPaths();
+ IMPORT_C TPtrC EmulatorPath();
+ IMPORT_C TPtrC EmulatorDataPath();
+ IMPORT_C TInt SetupEmulatedDrive(const TChar aDrive,const TDesC& aPath);
+ IMPORT_C TInt MapEmulatedFileName(TDes& aBuffer,const TDesC& aFileName);
+
+ These functions are defined in new file
+ \E32\UPWINS\UP_PATH.CPP, and replace various drive-mapping
+ activities in different places in E32 and F32. They also
+ incorporate changes to make the Emulator runnable from
+ anywhere. If the Emulator is running from a traditional
+ \Epoc32\Release\WINS\<build>\ directory, then emulated C: and Z:
+ drives and the Emulator data directory will be as before;
+ otherwise, emulated C: and Z: will be subdirectories 'C' and 'Z'
+ of the Emulator directory, and the Emulator data directory
+ will be the 'data' subdirectory of the Emulator directory.
+ 7) Fixed Epoc Software problem SW1-153 "Allow applications to simulate
+ running from C: or D: on WINS". F32 has been changed so that
+ an Epoc path, rather than a full Win32 path, is passed to
+ the kernel's DPlatLibrary::DoLoad() function. The path is mapped
+ to a Win32 path using MapEmulatedFileName() for the Win32 call to
+ LoadLibrary(), but DPlatLibrary.iFileName is set to the Epoc
+ path rather than the full Win32 path. It is iFileName that function
+ RLibrary.FileName() returns. Previously F32 would
+ pass in the full Win32 path and DPlatLibrary::DoLoad() would
+ convert it to an Epoc path to set the iFileName value, but for
+ libraries on the emulated Z drive only.
+ 8) In \E32\KPWINS\KP_GUI.CPP, replaced some old dos function
+ calls with newer, more UNICODE-friendly, Win32 ones.
+ 9) Added 2 new, case-sensitive, command-line flags.
+ Use EPOC.EXE -C<emulated C drive> -- (that's 2 dashes) to
+ specify the emulated C drive.
+ Use EPOC.EXE -T -- to specify that the system temporary path
+ should be used as the emulated C drive.
+ These flags will override the default settings and any _EPOC_DRIVE_C
+ setting in the environment or in the System.ini file.
+ 10) Removed obselete code defaulting maximum free RAM under WINS from
+ \E32\KPWINS\KP_HAL.CPP. The default is now applied by
+ \E32\KPWINS\KP_GUI.CPP.
+ 11) Changes to support international keyboard variants - these changes
+ will mean that WSERV version 100 (or above) and it's corresponding
+ changes are required to provide sensible keyboard behaviour.
+ a) Changed WINS EKERN.DLL so that character codes are passed onto the
+ Window Server in the 2 high bytes of the TRawEvent iScanCode
+ member variable.
+ b) Changed WINS EKTRAN.DLL to translate Epoc scan codes to the
+ character code provided in the 2 high bytes of the aScanCode
+ parameter if this code is available.
+ c) Changed EWSRV.DLL so that the 2 high bytes of the TRawEvent
+ iScanCode are ignored where appropriate.
+ d) Changed WINC ECONS.DLL to support international keyboard
+ input.
+ e) Removed \E32\KPWINS\KP_KYBD.CPP - this file used to provide
+ limited international keyboard support - UK/US variants only.
+ 12) Added KConsoleDllUid, 0x100000C5, to \E32\INC\E32UID.H.
+ 13) Made changes to \E32\WSRC\CO_TWIN.CPP to resolve the ECONS.DLL
+ problem in line with the version of Epoc S/W Proposal SW1-84
+ revised 27/8/98. Some changes to the Eikon console will be
+ required for the solution to be fully effective. The changes
+ don't go quite as far as the proposal - the text console only
+ attempts to load ECONSEIK.DLL, not ECONS?*.DLL, since the
+ dll-loading code does not handle wildcards.
+ 14) Changed \E32\KPWINS\KP_GUI.CPP so that under WINS the pointer
+ name (TMachineInfoV1.iXYInputName) is always either _L("PEN"),
+ _L("MOUSE") or _L("NONE"). This value can be set via
+ \Epoc32\Data\System.ini using keyword "PointerType", and
+ defaults to _L("PEN"). E.G. "PointerType mouse".
+ 15) Changed \E32\KPWINS\KP_GUI.CPP to allow Emulator windows to be
+ created which are larger than the PC screen.
+ 16) Changed \E32\GROUP\SWINS.REL to include the new symbian fascia.bmp and
+ friends from R:\SDK\ZIP\SDKMODELS.007.
+ 17) Added new function and an enum to E32WINS.H
+
+ IMPORT_C TInt EmulatorFlip(TEmulatorFlip aEmulatorFlip);
+ enum TEmulatorFlip
+ {EEmulatorFlipRestore,EEmulatorFlipInvert,EEmulatorFlipLeft,EEmulatorFlipRight};
+
+ Calling this function, defined in \E32\UPWINS\UP_GUI.CPP, will change
+ the size and orientation of the emulator's parent and child windows
+ and bitmap.
+ 18) Implemented Epoc Proposal SW1-93 "Help for debugging Panics on WINS".
+ In WINS DEBUG mode, when a thread is panicked, a function in
+ \E32\UPWINS\UP_DEBUG.CPP will be called which will break into the
+ debugger and provide comprehensive information about the panic. Source
+ file UP_DEBUG.CPP will be needed for this to work properly. I've
+ removed the __DEBUGGER() macro from RThread::Panic() since it should no
+ longer be required.
+ 20) Added 2 new functions to E32WINS.H - AddToWinsEpocThreadList() and
+ RemoveFromWinsEpocThreadList(). These enable the kernel to create and
+ maintain a list of "real" Epoc threads (as opposed to fake WINS
+ hardware threads) within EUSER.DLL. New function
+ UpWins::__EpocThread() in UP_STD.H is called by EDLL.OBJ (linked into
+ every WINS Epoc dll) to check whether the current thread is in this
+ list, so that EUSER's E32Dll() routine is only called when real Epoc
+ threads attach to and detach from loaded Epoc dlls. As a result of
+ this change dlls linked to the new version of EDLL.OBJ will not run
+ against older versions of EUSER.DLL. All these new functions are
+ defined in new file \E32\UPWINS\UP_THRD.CPP. This change addresses
+ Epoc Proposal SW1-19, though I haven't removed the calls to E32Dll()
+ with parameters EDllProcessAttach and EDllProcessDetach yet since the
+ window server, and perhaps other components, make use of these.
+
+4) Morgan
+ 1) Added interrupt chaining to TInterrupt. This breaks binary
+ compatability for this class, but maintains source compatability.
+ Attempts to Bind the old TInterrupt class with the new kernel will
+ fail with KErrNotSupported.
+
+
+Version 1.02.151
+================
+(Made by Pete, 12 October 1998)
+
+1) Morgan
+ 1) Updated TLinda and KEMAD\KE_PIC.CPP to take the new interrupts
+ 2) Added some kernel access functions so device drivers can
+ find DPhysicalDevices, DLogicalDevices, DChunks, and DLibraries
+ 3) Added TDma::Fill()
+ 4) Fixed a bug in the ImpDma interface
+ 5) Added hooks for automatic chaining of Dma buffers
+
+2) Pete
+ 1) Re-organisation of the SPI bus / ADC channel
+ measurement code in MARM and MAWD builds:-
+ TSpiController is now an abstract class. A
+ TSpiController derived class is defined and instanciated in each
+ variant. During initialisation, the kernel calls
+ TSpiController* Custom::CreateSpiController() to create the
+ appropriate SPI controller device.
+ TSpiController now includes the following
+ pure virtual functions which (hopefully) encompass the variant
+ specific aspects of this device:-
+ - void TSpiController::InitialiseSpiDevice();
+ - void TSpiController::StartAveragedReading();
+ - void TSpiController::StartOneShotReading();
+ Created the file VA_SPI.CPP in each MARM/MAWD
+ variant to implement the above functions (the code for which
+ has been essentially extracted from the appropriate KE_SPI.CPP
+ file). Also moved the following SPI related functions out of
+ VA_HW.CPP into VA_SPI.CPP:-
+ - TBool Custom::TestBootSequence()
+ - TInt Custom::BindSpiChannel(const TDesC8& aName)
+ - TBool Custom::EightChannelAdcFitted().
+ The TSpiController device no longer relies on
+ the digitizer driver to drive it to pull off and process
+ entries from its queue of ADC channels waiting for an ADC reading.
+ The Controller now has its own 8mS tick to perform
+ this. The later can be suspended/resumed by the variant using:-
+ - void TSpiController::Suspend();
+ - void TSpiController::Resume();
+ (For PB-PD/P2 MARM and B1 MAWD variants, the
+ digitizer driver does indeed suspend this operation and
+ drives processing of pending channels itself so as not to
+ change the operation of this driver).
+ 2) Re-organisation of the way the PC Card Controller
+ hardware (e.g. Etna) is implemented for MARM builds to make
+ use of the fact that the variant DLL can now contain static
+ data. The h/w chunks are no longer allocated in the
+ architecture layer (KE_INI.CPP), but are
+ allocated within the variant as part of the Custom::Init3()
+ function. As such, the function
+ Custom::PcCardCntrlPhysicalAddress() has become redundant.
+ 3) The function Hal::ColdStart() is now properly
+ exported.
+
+3) Petteri
+ 1) Changes to MARM display driver (WD_EIGER.CPP) so to handle
+ different screen sizes. Previous one assumed 640x240.
+ 2) Changes to bootstrap and MARM variant layer to allocate an
+ additional h/w chunk for the extra registers in the CL-PS7111 device.
+ 3) Various changes to the Cirrus Logic evaluation board
+ variant - to bring back as a supported variant.
+
+4) Dennis
+ 1) Put SCREENVARIANT code back into MARM bootstrap.
+
+Version 1.02.150
+================
+(Made by Alastair, 23rd September 1998)
+
+This release is not intended for ER4, though it could be used as part
+of an ER4 SDK.
+
+1) Alastair
+ 1) Changed ECDRV.PDD, ESDRV.PDD and ESOUND.LDD as suggested by replies
+ to topic "WINS sound and comms cause deadlocks with STDLIB" under
+ category "Known Epoc Problems" in Notes database
+ "Symbian Tech Support General", except that the change to
+ ECDRV.PDD has been modified slightly so that it doesn't break test
+ T_SERIAL.EXE. The ECDRV.PDD change has been tested with a version of
+ T_SERIAL.EXE modified to simulate the conditions which
+ could previously cause deadlock.
+ These changes address the following bugs/proposals, but do not
+ represent a permanent solution:
+ Epoc Software problem SW1 - 176 "WINS sound driver
+ deadlock in ESTLIB E32Dll() function."
+ Series5 Software problem SW1 - 503 "ECDRV.PDD can cause
+ deadlocks in simple test programs".
+ Epoc proposal SW1 - 19 "Implement true EPOC32 handling of
+ E32Dll() under WINS".
+ The change to ESOUND.LDD fixes Epoc Software problem SW1 - 179
+ "ESOUND.LDD plays silence indefinitely for short sound samples".
+
+
+Version 1.02.144
+================
+(Made by Dennis, 7th August 1998)
+
+1) Matthew
+ 1) Added code to MISA platform so that the cpu goes into idle mode when
+ in the idle thread.
+ 2) Added \e32\keisa\todo.txt - a to-do list for the MISA platform.
+
+2) Dennis
+ 1) Fixed bug in comms device driver D_COMM.CPP which left unwanted DFCs
+ queued after a power-down. These then attempted to complete requests
+ twice. Power down now cancels any pending DFCs.
+
+3) Jonathan
+ 1) Removed tests for redundant files from valid command in mnt.bat.
+ 2) Updated build.txt to add dire warnings about checking e32ver.h and
+ advice about MNT VALIDating releases.
+
+
+Version 1.02.143
+================
+(Made by Pete, 20th July 1998)
+
+1) Dennis
+ 1) Fixed SW1-586 incorrect handling of signed zeros.
+
+2) Morgan
+ 1) Updated V32Linda.h to reflect the latest hw
+ 2) Added TDma class and supporting classes Dma, ImpDma
+ 3) Changed MMAD bootstrap to use the same modular scheme as MARM
+
+3) Alastair
+ 1) Fixed Epoc Software problem SW1-107 'WINS RThread::Resume problem on
+ Win95' by not faulting the platform unless Win32 API function
+ GetLastError() reports an error as well as ResumeThread().
+
+4) Pete
+ 1) Fixed a problem with ATA media driver such that it sometimes failed
+ to reduce machine current consumption - having raised it due to a
+ read or write to the CF card.
+ 2) Fixed a problem with ATA media driver. As part of the exec. call to
+ read/write/format the card, the driver sends a command to the card,
+ to read/write the appropriate number of sectors. Each time a sector
+ is complete, the card generates an interrupt so the driver can
+ either read the data from the sector or supply the data for the next
+ sector to be written. There was a problem with the driver such that,
+ if the first interrupt from the card occurred while still in the
+ initial exec. call, the interrupt could be prematurely cleared. The
+ driver then only detects that the sector has been processed when a 2
+ second time-out occurs on the operation - making the operation
+ appear very slow. This only seems to have been a problem for Viking
+ and Panasonic CF cards.
+ 3) Alteration to the ATA media driver to improve speed of transfer,
+ particularly on reads from the card. Before, the driver queued a DFC
+ for the completion of each sector read from the card (to write it
+ back the thread making the request). The media driver's buffer has
+ now been increased so that this can be filled under interrupt. A DFC
+ in now only queued when the buffer is full.
+
+
+Version 1.02.142
+================
+(Made by Pete, 1st July 1998)
+
+1) Matthew
+ 1) Changed MISA bootstraps to use the same modular scheme as MARM.
+ 2) Added functions to TSa1100 for new hardware registers in revision D.
+1) Dennis
+ 1) Added thread write function DThread::WriteNoCheck() which doesn't
+ perform the strict checking that DThread::Write() does.
+ 2) Changed TLex::Val(TReal*) to use TRealX in its intermediate
+ calculations in order to increase the precision of the final
+ result. Added a new function Math::MultPow10X which multiplies a
+ TRealX argument by an integer power of 10. This is basically a
+ higher precision version of Math::Pow10.
+1) Pete
+ 1) Changed MARM ATA and CROM media driver to use
+ DThread::WriteNoCheck(). Fixes SW1-482.
+
+
+Version 1.02.141
+================
+(Made by Pete, 10th June 1998)
+
+1) Jonathan
+ 1) Removed private assignment operators from TSglQueIterBase and
+ TDblQueIterBase as per EPOC32 Proposal SW1-53.
+ 2) Made inline RSubSessionBase::SubSessionHandle() public as per EPOC32
+ Proposal SW1-45.
+ 3) Bumped up the E32 KMediaDriverInterface*VersionNumber.
+ 4) Changed the default WINS memory emulation from 4MB to 64MB as per
+ EPOC32 Proposal SW1-88.
+ 5) New code page 1252 and Unicode character information tables derived
+ from release 2.1 of the character database from Unicode Inc.
+ Fixes EPOC32 Software Problems SW1-42 and also adds:
+ 80 & U+20AC New euro currency symbol
+ 8E LATIN CAPITAL LETTER Z WITH CARON (= U+017D)
+ 9E LATIN SMALL LETTER Z WITH CARON (= U+017E)
+ U+FFFC OBJECT REPLACEMENT CHARACTER
+ 6) From Graham Asher:
+ The enumerated type TChar::TCategory in e32std.h, used only in the
+ Unicode build, has been changed to accommodate the new character
+ categories in unidata2.txt.
+
+2) Matthew
+ 1) Changed the TSa1100 class - removed SetHalt(), which had been
+ copied over from TEiger, and renamed IntLevels() to IntsPending()
+ and IntTypes() to IntLevels() to conform with the terminology in
+ the SA1100 documentation. Breaks misa kernel-side compatability.
+ 2) Removed lccr followers from MISA, which were working around a bug
+ in the SA1100.
+ 3) Changed MISA ScreenInfo function to return the address of the
+ beginning of the palette (rather than the pixel data for 8bpp).
+ The screen driver will have to change to take account of this.
+ 4) Removed TSa1100 palette functions - the screen driver should write
+ to memory instead.
+ 5) Removed Cassius-A releasables from the releasables, because we had
+ the hardware taken from us.
+ 6) Changed Windamere(AWD) and SARMBE architectures to set year to
+ rombuild year on a cold boot, which I forgot in the last release
+ (see 3.13 in release 140).
+ 7) Fixed Epoc32 defect SW1-33 ("Problem in Plat::Fault in Unicode
+ builds") by changing Length() calls to Size() calls.
+ 8) Changed sound ldd to use DThread::Read() and Write() rather than
+ doing its own thing this fixes S5 defect SW1-231 ("Machine warm
+ reset when playing sound while spy running").
+ 9) Changed svChangeLocale() function so that it triggers
+ RChangeNotifiers.
+ 10) Changed keyboard translator dll so that the default library is
+ closed when not in use.
+ 11) Incremented EPOC comms-driver minor version number (but not WINS
+ one) and put a check into the pdds so that they will not be used
+ with early versions of the ldd. Partially fixes Bluebell defect
+ SW1-5 ("Triple beep reset when turning on the link").
+ 12) Added an explicit call to compress the kernel heap to
+ S::ChunkCompressAll(). This fixes the E32 bit of Series-5 defect
+ SW1-356 ("Large uncompressible heaps in system components").
+ 13) Fixed bug in sound ldd which caused sine waves to not be
+ cancelled in WINS on PCs which did not support aLaw.
+
+3) Dennis
+ 1) Fixed bug in ARM710.S in EIGER bootstrap code. In function
+ EigerSetCSnWidth register R1 is accidentally overwritten, causing
+ the ROM to be set up incorrectly if its bus width is not 32 bits.
+ 2) Implemented EPOC32 proposal SW1-69. User::StartThread modified to do
+ the DLL attach and detach in separate functions, so that the 1K of
+ stack used in these functions can be reused during actual running of
+ the thread.
+ 3) Fixed problem SW1-51 - renamed TPointerArray<T> to RPointerArray<T>
+ and TSimpleArray<T> to RArray<T>. Replaced TArray(U)Int with
+ RArray<T(U)Int>. Replaced the destructor with a Close() function to
+ do memory deallocation. Frozen DEF files modified so that renamed
+ functions are at same ordinal as before, with Close() functions at
+ the same ordinals as the destructors were.
+ 4) Fixed problem SW1-47 - modified code in DebugFunction ProfileResult
+ to get the tick period from Hal::TickPeriod instead of hardcoding it
+ to 15625us.
+ 5) Fixed problem SW1-622 - modified heap code so that all free cells
+ are at least 16 bytes in debug mode, since this is the minimum
+ allocated cell size.
+ 6) Modified RHeap::ReAlloc() so that the nestingLevel field in debug
+ mode is preserved. This prevents test programs failing a kernel
+ heap check due to one of the kernel's arrays being reallocated
+ during the test.
+ 7) Modified handlers for vectors 0x00 and 0x14 (reset and reserved) to
+ fault with a simulated exception EExcInvalidVector rather than
+ looping forever. iCodeAddress=0x00 or 0x14, iDataAddress=value of
+ lr on jumping to 0x00 or 0x14.
+ 8) Added functions RChunk::IsReadable() and RChunk::IsWritable() so
+ that user code can determine whether or not a chunk is mapped into
+ its process address space.
+ 9) Fixed problem SW1-370 (Math::Mod is not sufficiently
+ accurate). Changed the algorithm from x%y=x-y*INT(x/y) to a
+ bit-by-bit shift and subtract algorithm. Added operator%,
+ operator%=, Mod() and ModEq() functions to TRealX class to implement
+ the new algorithm.
+
+4) Petteri
+ 1) Fixed a bug in Math::Round(). (SW1-402)
+ 2) Fixed a couple of bugs in the text window server.
+ 3) Changed Ekern.mmp as required by changes in Makmake.
+
+5) Alastair
+ 1) Changed mnt.bat so that mnt getsrc no longer attempts to make
+ the Epoc work directories.
+ 2) Changed WinCOutput::Write(const TDesC &aDes) so that WINC
+ programs can write output to STDOUT for redirection. This change
+ applies to ascii builds only.
+ 3) Changed the kernel so that the Windows Alt-F4 keyboard
+ shortcut for closing applications works for WINS.
+ 4) Changed #define in kpwins\kp_chunk.cpp so that the code which
+ checks that requests for more memory won't cause the emulated
+ memory allocation limit to be exceeded applies for WINS only, not
+ WINC. This won't change WINC behaviour because the emulated
+ memory limit under WINC was always zero, which meant that the
+ check wasn't applied anyway.
+ 5) Changed kpwins\kp_gui.cpp in line with Epoc Proposal SW1-21,
+ so that emulated drive assignment is possible from
+ \Epoc32\Data\System.ini.
+ Syntax is
+ _EPOC_DRIVE_<letter> <path>
+
+6) Jo
+ 1) Fixed Series 5 software problem SW1-440 ("PDD returns different errors
+ in WINS and ARM"). Both WINS and ARM now return KErrNotSupported.
+ 2) Fixed Series 5 software problem SW1-943 ("XXX_CAST macros in E32DEF.H
+ are written incorrectly")
+
+7) Pete
+ 1) Implemented asynchronous rather than synchronous system
+ for read,write and format operations on local media devices.
+ This affects the TLocDrv and DMediaDriver classes.
+ 2) Changed API on for local media devices so that for any given
+ operation (eg read,write,format,reduce size) the position on the
+ device is specified as a TInt64 rather than TInt. This will allow
+ very large media devcies to be supported. This affects the TLocDrv,
+ DMedia and DMediaDriver classes.
+
+ Taking changes 1 & 2 for DMediaDriver, the functions
+ TInt DMediaDriver::ReduceSize(TInt aPos,TInt aLength);
+ TInt DMediaDriver::Read(TInt aPos,TInt &aLength,const TAny* aTrg,TInt aHandle,TInt anOffset);
+ TInt DMediaDriver::Write(TInt aPos,TInt &aLength,const TAny* aSrc,TInt aHandle,TInt anOffset);
+ TInt DMediaDriver::Format(TInt aPos,TInt &aLen);
+
+ become:-
+ TInt DMediaDriver::ReduceSize(TInt64 &aPos,TInt aLength);
+ void DMediaDriver::Read(TInt64 &aPos,TInt *aLength,TLocalDriveMessageData &aTrg,DThread *aThread,TRequestStatus *aStatus);
+ void DMediaDriver::Write(TInt64 &aPos,TInt *aLength,TLocalDriveMessageData &aSrc,DThread *aThread,TRequestStatus *aStatus);
+ void DMediaDriver::Format(TInt64 &aPos,TInt *aLength,DThread *aThread,TRequestStatus *aStatus);
+ 3) Withered the UserPcCardCntrl class. Now all functions are 'not supported'
+ apart from:-
+ void UserPcCardCntrl::PwrDown(TSocket aSocket);
+ TInt UserPcCardCntrl::NotifyChange(TSocket aSocket,TRequestStatus *aReqStat);
+ which are implemented using the corresponding UserSvr functions
+ described below.
+ The media device functions previously provided by UserPcCardCntrl
+ are now provided by D_DRVIF.LDD in E32UTILS.
+ The PC Card controller functions previously provided by UserPcCardCntrl
+ are now provided by D_PCCDIF.LDD in E32UTILS.
+ 4) Added the following UserSvr local media functions:
+ void UserSvr::ForceRemountMedia(TMediaDevice aDevice);
+ Causes remount on next access to specifed device (ie
+ media change simulation).
+ TInt UserSvr::MediaChangeNotify(TMediaDevice aDevice,TRequestStatus *aReqStat);
+ Request notification of power of powerup and media change
+ events on the specified media device.
+ 5) In MARM build the function:-
+ TInt DArmPlatPcCardSocket::EventCallBackEnable(TPccdEvent anEvent)
+ no longer performs a clear of any pending events before enabling an
+ event callback type. Also, it now performs an additional check that
+ a power down of a PC Card hasn't occured (ie Kern::PowerGood()) before
+ enabling PC Card IREQ events.
+
+
+Version 1.02.140
+================
+(Made by Morgan, 14th May 1998)
+
+1) Graham
+ 1) Added P3 variant to the rom building capabilities in KBARM
+
+2) Dennis
+ 1) Added support for multiple kernels/variants in the same ROM.
+ This requires F32 096 and ROMBUILD version 093.
+ 2) Added TSimpleArray<>, TPointerArray<>, TArrayInt simple array classes.
+ 3) Changed occurrences of CArray* in the kernel to TSimpleArray<>.
+ 4) Rearranged ARM boot code into a form which is easier to adapt to other
+ hardware and which facilitates multiple-boot ROMs.
+ 5) EKERN.EXE no longer links to the variant DLL. Instead, the variant DLL
+ is found by searching a list of possible variants.
+ 6) Added executive call UserSvr::RomRootDirectoryAddress() to enable F32 to
+ obtain the address of the ROM file system root directory. This address is
+ now determined at boot time from a list of possible root directories, one
+ for each variant which the ROM supports.
+ 7) Added code to enable profiling of threads (measures CPU time used by each
+ thread in the system). To use this, rebuild the MARM REL version with the
+ symbol __PROFILE__ defined at the top of M32STD.H. You will also need test
+ program T_PROF.EXE and device driver D_PROF.LDD from E32TEST.
+ 8) Added two new format options %O and %o to Kern::Printf. %o prints the short
+ name of a CObject and %O prints the full name. Also modified Kern::Printf
+ to print (null) if a NULL pointer is passed into %S, %O or %o.
+ 9) Modified statements of the form Kern::Printf(_L("%S"),&obj->FullName())
+ to Kern::Printf(_L("%O"),obj).
+ 10) Added a generic algorithm for determining the size and configuration of
+ DRAM devices to the ARM bootstrap code.
+ 11) Modified ARM/ISA/X86 bootstrap to map in the PageTableInfo array at
+ 0x41080000. The fixed offset from the page directory simplifies remapping
+ during a reschedule.
+ 12) Added fields iHomePdes, iPdes and iNumPdes to the definition of DPlatChunk.
+ These indicate directly which PDEs are used by the chunk and simplify
+ moving a chunk around. Modified the scheduler to use these fields when
+ switching processes. Added a function DPlatChunk::SetPdeInfo to set up
+ these fields.
+ 13) Removed the current consumption setting code from the scheduler. Added
+ a function K::TotalCurrentConsumptionInMilliAmps() which calculates the
+ machine current by adding K::TotalCurrentMilliAmps to the machine current,
+ determined by simply looking to see if the null thread is running.
+ 14) Modified DPlatProcess::LookupChunk to do a binary search on the chunk list
+ instead of a straight entry-by-entry search.
+ 15) Fixed a bug in DPlatChunk::ReallocateHomeAddress which would result in a
+ chunk being left without a home address if all linear addresses in the
+ home section were exhausted.
+ 16) Modified text window server so that it loads EDISP.DLL from Z:\SYSTEM\LIBS
+ and invokes ordinal 1 in order to create the screen device driver, rather
+ than being statically linked to EDISP.DLL. This is necessary for multi-boot
+ ROMs since EDISP.DLL is hardware dependent.
+ 17) Added WINDERMERE architecture (\E32\KEAWD), Bluebell V1 variant (\E32\VAWDB1),
+ and dual-boot EIGER/WINDERMERE test ROM (\E32\KBAWD).
+ This builds and runs on Rack D but is obviously completely untested on
+ Windermere. There are some outstanding issues with the Windermere port:
+ i) Standby code may be faulty - problem with restoring state when machine
+ powers back up.
+ ii) PC card/CF card code requires modification to use LDRH/STRH 16 bit
+ instructions rather than relying on EIGER 'mad-mad mode'.
+ iii) Bootstrap needs modifying to detect Windermere.
+ iv) SPI controller and LCD controller setup may be incorrect.
+
+3) Matthew
+ 1) Got rid of MARM P1 (banana) variant.
+
+ 2) Bug fixes to MISA so it can be run in 4bpp and 16bpp modes.
+
+ 3) Changed misa to use the hardware rtc to keep track of the time, instead of
+ counting ticks.
+ Unfortunately the 32MHz crystal is very slow to warm up, so a cold boot is now
+ much slower than it was because it has to wait for the crystal to stabilise.
+
+ 4) Changed misa bootstraps to be fractionally more like the marm one.
+
+ 5) Moved the WINS-specific setting of the daylight-saving mode out of the
+ independent layer and into KPWINS. Removed the resetting of the
+ daylight-saving from the change-locale function. These mean that S5
+ defect SW1-558 ("Remove windows dependency") has been fixed.
+
+ 6) Fixed bug in DLogicalChannel::Request(), which previously, in WINS,
+ could have sent a request from a thread which had no right to do a request
+ on that channel.
+
+ 7) Integrated Andrew Baldwin's wonderful new WINS sound pdd, which will not
+ offend your ears. Many thanks to Andrew for this.
+
+ 8) Modified sound ldd so that it can pass multiple samples to the pdd. Modified
+ pdds to use this new functionality. This reduces the amount of time spent in
+ the service routine.
+
+ 9) Fixed S5 defect SW1-228 ("Dial setup errors") in sound LDD.
+
+ 10)Incrememented sound driver minor version number, to stop people mixing old
+ and new pdds/ldds.
+
+ 11)Put an __DEBUGGER() macro into K::PanicCurrentThread() - previously these
+ panics were just stopping WINS without giving you a chance to jump in with
+ a debugger.
+
+ 12)Added int3's to WINS DEBUG versions Plat::Panic() and Plat::Fault() so they
+ break into the debugger whatever the state of the JustInTime flag.
+
+ 13)Changed MISA and MARM cold-boot to read the year from the rom header and set
+ the time to 10:10 January 1st of that year. Fixes Bluebell defect SW1-134.
+
+ 14)Made the private function KernelCompressAll() into the public
+ User::CompressAllHeaps(). This is to allow Shell to trigger heap compression
+ more easilly (see Bluebell defect SW1-299).
+
+4) Morgan
+ 1) Integrated the MADLinda architecture and build system
+ 2) Bug fix to KESARMBE\KE_PIC.CPP
+ 3) Changed occurences of DisableIrqs and EnableIrqs to DisableIrqsToLevel2 and
+ RestoreIrqs in SARMBE architecture
+ 4) Added callback hook for the idle loop
+ 5) Added Kern::PhysicalDeviceFromHandle
+ 6) Added an external debugger interface (K32DBG.H). Used it to bolt on an
+ InfoOutput debugger for MSDEV. On the MARM platforms bolted on a logging
+ debugger for use by an external JTAG debugger, (like TI's). No debugger
+ for X86.
+
+5) Jonathan
+ 1) Made Eiger and Windemere text drivers return correct screen size
+ from CScreenDriverMarm::Init() instead of assuming 80x24.
+ Removed old #ifdefed-out SetMode() code from Eiger driver.
+
+
+================
+Big version number increment to skip over Liffey release.
+================
+
+Version 1.02.128
+================
+(Made by Jonathan Harris, 8th May 1998)
+
+1) Jonathan
+ 1) P::SetMachineConfiguration(): Don't update the bits of the SuperPage that
+ belong to the boot code (including the exception info), apart from the
+ display contrast.
+
+
+Version 1.02.127
+================
+(Made by Graham Darnell, 26th March 1998)
+
+1) Dennis
+ 1) Added a new variant function Variant::SetSoundDriverEnabled(TBool) for use
+ with Snowball in order to allow user code to enable/disable the speaker
+ using UserHal::SetSoundDriverEnabled().
+
+ 2) Added some code to Variant::Init3 for P2 variant to enable correct operation
+ with either a single ROM device, 4Mb on CS0 and 2Mb on CS1, or 4Mb on both.
+
+2) Matthew, Pete and Rob Pym
+ 1) Converted the MISA build from being for a Digital IT board to being for
+ SA-1100 based hardware. This has an identical user-side API to MARM, so
+ MARM releasables will run unchanged. To build a rom use the MARM F32.
+
+ 2) Added variants VISABA for a Digital's "Brutus" board and VISACA for a
+ Cassius rack.
+
+ Note: TO BUILD A TEXT-SHELL ROM FOR BRUTUS YOU WILL NEED THE ESHELL.EXE
+ FROM F32 096 OR HIGHER. PRIOR TO THIS, THE SHELL TRIES TO CREATE
+ A CONSOLE WINDOW LARGER THAN THE BRUTUS SCREEN AND CRASHES.
+
+3) Matthew
+ 1) Changed all interrupt-binding and startup-beep internals to use Narrow
+ descriptors in the Unicode build.
+
+ 2) Added code to read extra digitiser information in E2 on P1, P2 and PD
+ variants. Changed the digitiser drivers on P2 and PD machines to use this
+ extra information, so different digitisers can be used on these machines.
+
+ If the new E2 information is invalid due to a new rom has been put into
+ an old machine, then this is detected due to the x rise-time being zero,
+ and the driver defaults to the previous good values.
+
+ If you wish to program your E2 with values suitable for the standard
+ digitiser use XYSpread/16=6; X-Rise=1; Y-Rise=1; Pen-down discard=0.
+
+ 3) Moved TVideoMode enum from d32video.h to e32twin.h, and stopped e32twin.h
+ including d32video.h, thus fixing SW1-921.
+
+ 4) Changed sound LDD to make sure that the internal state is implies no
+ request is pending when a play request is completed. Thanks to Andrew
+ Baldwin for finding this.
+
+ 5) Changed some RChangeNotifier internals so that the internal state implies
+ no request is pending when a request is completed.
+
+4) Graham/Matthew
+ 1) Changed the WINC memory information function so that it doesn't emulate a
+ machine with 4 megs of ram.
+
+ 2) Removed some critical-section switching in the WINS thread-startup code.
+ This fixes a bug which occasionally caused WINC to hang on fast machines
+ if a thread did an exec call very soon after being resumed for the first
+ time.
+
+ 3) Removed another 'dance of the semaphores' during WINS thread
+ startup. This seemed to prevent a resumer proceeding
+ until all resumee dll entry points have been called. Since
+ there seems to be no reason for this and since this was
+ causing a problem when threads were resumed inside
+ dll entry code, there seemed no point in keeping it.
+ However, this might be something to watch out for.
+
+ 3) On WINS/WINC, the call to tick the tick-queue is now sandwiched between a
+ Plat::EnterCS() and a Plat::LeaveCS(). This will make these platforms far
+ more robust, but might break work-arounds that may or may not exist in
+ user code.
+
+5) Morgan
+ 1) Fixed Bluebell defect SW1-43.
+
+ 2) Added Dll::FreeData(). This should be called in the EProcessDetatch
+ of those Dlls sporting static data.
+
+6) Graham
+ 1) Added comms and sound device drivers to the WINC
+ releasables.
+
+
+Version 1.02.126
+================
+(Made by Jonathan, 26th February 1998)
+
+1) Matthew
+ 1) Tweaked MMP files in preparation for misa platform.
+
+ 2) Added lots of useful constants to k32std.h - these will be used in the
+ misa platform.
+
+ 3) Removed the obsolete DriveName and PccdSlotHame() functions from the
+ variant layers.
+
+2) Graham
+ 1) Added K32KEYS, K32COMM, and K32SND header files to INCK release
+
+ 2) Split off the S1 variant into its own project
+
+ 3) Removed S1 variant from E32 project
+
+ 4) Fixed a bug in the MARM architecture that assumed that an eight channel
+ ADC was fitted when powering up.
+
+3) Dennis
+ 1) Modified RHeap definition so that it is now derived from RHeapBase,
+ which contains all the non-debug data members. This is to force GCC
+ to put the vptr in the same place that it always was in release builds.
+ This is to enable test code to run on a real machine with EUSER.DLL
+ replaced from RAM.
+
+ 2) Changed UP_CON.CPP in UPMARM, UPMX86 and UPWINS to only include <e32def.h>
+ instead of up_std.h. Previously, modifying k32std.h would cause up_con.cpp
+ to be rebuilt but not the real econs.dll.
+
+4) Alastair
+ 1) Added edll.pdb and eexe.pdb to ewinsdb.rel because following the move
+ to using makmake edll.obj and eexe.obj no longer contain their own
+ debugging information.
+ 2) Updated .MMP files previously using the START MARM .. END block keyword
+ DLLNAME so that they use the new LINKAS keyword instead. Updated MNT.BAT
+ to get e32tools 091 and e32toolp 091.
+
+5) Jonathan
+ 1) Added new SwitchOn() digitizer driver call. Needed by the Snowball
+ variant to reinit the digitizer after power-off.
+
+
+Version 1.02.125
+================
+(Made by Graham, 16th February 1998)
+
+1) Morgan
+ 1) Allowed static data for Rom Ldds/Pdds. These require the 'fixed'
+ keyword in the obey file.
+
+2) Graham
+ 1) Removed debug/release interoperability from WINS/WINC.
+
+
+Version 1.02.124
+================
+(Made by Jonathan, 10th February 1998)
+
+1) Jonathan
+ 1) Incremented KMediaDriverInterfaceMinorVersionNumber because the
+ media interface has changed (actually, it changed back in 120).
+ 2) Added new TPasswordToken member to TMachineConfiguration on WINS,
+ updated on setting the password or machine configuration.
+ 3) For internal consistency, WINS now actually limits the amount of
+ available memory on the 'machine' to the parameter set in
+ system.ini, and defaults to 3M if no value is set. Previously WINS
+ merely _reported_ 3M if no default was set, but allowed you to
+ allocate past 3M. This broke test code.
+ 4) Fixed generation of event on Off keypress on Snowball 1.
+ 5) Incorporated Pete's change: Snowball 1 variant no longer waits for
+ 400ms for SanDisk to come out of reset. Instead, the media driver
+ polls the SanDisk on first use.
+
+2) Alastair
+ 1) Updated e32base.h and ub_sec.cpp with Andrew Thoelke's changes to
+ implement EPOC32 proposal PR-0077, that a new function be provided
+ to return the maximum possible length that an encrypted piece of
+ data could become under the encryption scheme in use given the
+ initial length of the data.
+ 2) Changed mnt getrel so that it doesn't attempt to get the non-existent
+ .PDB files for release builds.
+
+3) Basher
+ 1) Changed K::EmergencyPowerDown() and K::EmergencyPowerDownDfcFn()
+ functions (ks_power.cpp).
+
+ 2) Changed Variant::EmergencyStandby() - on the folowing varients
+ varmcl, varmpd, varmsa and varmsb.
+
+ 3) \varms1\va_mati.cpp changed - implementing safe EmergencyPowerDwn
+ control. EmergencyCallBack function added and the SectorWrite function
+ changed to control emergency system shutdown to prevent Liffy's
+ internal CF card from corruption.
+
+4) Morgan
+ 1) Added VARMLA variant and bigendian support
+
+5) Graham
+ 1) Changed variant structure for VARMCL, VARMPB, VARMPC,
+ VARMPD, VARMP1, VARMP2, VARMS1, VARMLA.
+
+ The variant object is now created on the kernel heap.
+ This allows the variant code to have state and will
+ result in many simplifications of code that interacts
+ between variant and architecture layers. It will also
+ allow for improved customisation possibilities for
+ our licensees.
+
+ Questions concerning historical and cross-platform
+ binary compatibility are yet to be resolved.
+
+ 2) Cleaned up E32STD.H. This now follows the new standard:
+
+ CBase *Function(TDes &aParameter);
+ becomes
+ CBase* Function(TDes& aParameter);
+
+ 3) Snowball PTR2 varmsb and Delaware varmpg removed.
+
+6) Petteri
+ Changes to the text window server:
+ 1) Four different window classes have been reduced into just one.
+
+ 2) The notifier server now has a thread of its own and uses text window
+ server API for its output.
+
+ 3) ASCII font has been changed to get the window borders back.
+
+ 4) There is now a constant KCONSFULLSCREEN, which can be used to create
+ a full-size window whatever the size of the screen.
+
+ 5) Windows can be moved, resized and scrolled using the mouse or a pen.
+
+ 6) OnTop flag has been added. If the flag is set, the window stays on top
+ of other windows.
+
+ 7) The size of notifier windows now depends on the length of the text
+ which is being displayed. Buttons can have more than just one character
+ and they are centred. One button option now works properly. Pressing
+ ESCAPE returns value 0, ENTER returns 1. The notifier window stays on
+ top of other windows.
+
+ 8) Info prints are also variable-sized and they stay on top of other windows.
+
+ 9) System.ini files are now read correctly in Unicode build. (Files written
+ in Unicode cannot be read.)
+
+ 10) Colour support has been added. WINS supports a mode EColor256, where a
+ palette of 256 colours is available. SetTextAttribute() provides an easy
+ way to display text in colour. The following attributes are available:
+ ETextAttributeNormal, ETextAttributeBold, ETextAttributeInverse and
+ ETextAttributeHighlight. Palettes (if supported) can be manipulated and
+ read with SetPaletteEntry() and GetPaletteEntry(). SetTextColors() changes
+ colours for text foreground and background. Colours for window background,
+ window borders and screen background are set with SetUIColors().
+
+ 11) The text window server API has 8 new functions:
+ TInt SetWindowPosAbs(const TPoint &aPosition) (Sets window position.)
+ TInt ScreenSize(TSize &aSize) (Returns screensize in characters.)
+ TInt SetMode(TVideoMode aMode)
+ void SetPaletteEntry(TUint anIndex,TUint8 aRed,TUint8 aGreen,TUint8 aBlue)
+ void GetPaletteEntry(TUint anIndex,TUint8 &aRed,TUint8 &aGreen,TUint8 &aBlue)
+ void SetTextColors(TUint anFgColor,TUint aBgColor)
+ void SetUIColors(TUint aWindowBgColor,TUint aBorderColor,TUint aScreenColor)
+ void SetTextAttribute(TTextAttribute anAttribute)
+
+Version 1.02.123
+================
+(Made by Jonathan, 27th January 1998)
+
+1) Alastair
+ 1) Changed MNT.BAT so that no attempt is made to release PDB files for
+ WINS and WINC release builds, because MAKMAKE generated makefiles do
+ not create them by default.
+
+ 2) Removed references to defunct directory \e32\dmedia from MNT.BAT.
+
+2) Jonathan
+ 1) Drain the Snowball 1 digitizer FIFO before enabling its interrupt to
+ prevent it from generating spurious and unwelcome penup/downs on
+ startup.
+ 2) P::SetMachineConfiguration() : delete the current password and update
+ the password from the new configuration.
+ 3) Dropping DTR on Snowball 1's 2nd serial port (the phone port)
+ asserts the ONKEY signal to the phone, allowing users of that serial
+ port to turn the phone on/off.
+ 4) Corrected size returned by Custom::XYInputSize() on Snowball().
+ 5) Hugely simplified the Snowball 1 key data tables.
+ 6) Added special support for the Snowball 1's Off key in the keyboard
+ driver. But this doesn't work.
+ 7) Belatedly updated kbarm files with support for Snowball 1.
+
+Version 1.02.122
+================
+(Made by Graham, 23rd January 1998)
+
+1) Jonathan
+ 1) Snowball 1. Don't reset the ASIC on startup.
+
+2) Dennis
+ 1) New serial comms LDD and modified PDDs for all variants.
+
+ 2) WINS comms LDD is now separate from the real comms LDDs. WINS LDD lives in
+ DPWINS directory with the WINS PDD, and is currently the same as the old comms LDD.
+
+ 3) Added hooks to KEARM\KE_INT.CPP to allow another operating system to be bolted on to EPOC32.
+
+ 4) Added test program T_PTNOS.CPP with LDD D_PTNOS.CPP to test the partner OS hooks.
+
+ 5) Added a check to KPEPOC\KP_PROC.CPP to prevent two copies of a fixed-address
+ process from being created. DPlatProcess::DoCreate will leave with
+ KErrAlreadyExists if it finds a matching EXE code chunk belonging to a fixed
+ address process.
+
+ 6) Added some more facilities to T_TERM.CPP, including file upload and download
+ and loopback.
+
+ 7) Fixed typo in ARM boot code which caused problems by failing to map in the
+ CS1 ROM if ROM address 0x10000ec6 (physical) contained zero.
+
+ 8) Fixed bug which could cause processes to be run with incorrect domain access
+ if an interrupt occurs during a reschedule. This caused machine to reset
+ during heavy keyboard use.
+
+ 9) Added missing __NAKED__ declaration to ARM assembler versions of
+ TDes8::AppendNumUC() and TDes8::AppendNumFixedWidthUC().
+
+ 10) Fixed problem in DThread::Write() (all 3 variants) - it was returning an error
+ code if the source descriptor had zero length and a null pointer.
+
+3) Graham
+ 1) Created a new public header file - E32PANIC.H - which
+ contains the base panic numbers.
+
+ 2) Split the test programs off into a new E32TEST
+ project.
+
+ 3) Removed full exception handling from WINS and WINC if running under Windows '95.
+ E32's exception handling system relies on being able to asynchronously
+ meddle with another threads context and stack in order to inject a call
+ to an exception handler into that thread's normal train of execution. This
+ technique works with NT but Windows 95 is not up to it. It is clear that
+ not every operating system would be able to handle this. Consider, for example,
+ the possibility that the thread is inside an OS call when the call is injected.
+
+4) Alastair
+ 1) Moved build system over to MAKMAKE. The batch files for building E32 are
+ created by e32tools's BLDMAKE. From the GROUP directory, type BLD or CLEAN
+ or PREPARE without any arguments for help on how to use the new batch
+ commands. MAKMAKE has not yet been applied to the build system for MISA,
+ MX86. CLEAN.BAT uses NMAKE to do its cleaning, so a PREPARE.BAT
+ needs to have been done first. PREPARE.BAT will make the makefiles and
+ build the working directories.
+
+ 2) Renamed freeze files from .FRZ to .DEF, including CONSMARM.FRZ, CONSMISA.FRZ
+ and CONSWINS.FRZ.
+
+ 3) Removed WINS_UID statements from all source files.
+
+ 4) Changed EDLL.O, EXDLL.O, EEXE.O so they are built by separate makefiles
+ rather than that of EUSER for MARM.
+
+ 5) Changed KE_EXE.O so that it is built by a separate makefile rather than
+ that of EKERN for MARM.
+
+ 6) Added SARMBE platform to the build process so big-endian single-process ARM
+ platform can be built.
+
+
+Version 1.02.121
+================
+(Made by Graham, 10th Dec 1997)
+
+1) Dennis
+ 1) Fixed bug whereby CObjectIx::~CObjectIx could crash if Close()ing an object
+ in the index caused other objects to be removed from the index and thereby
+ caused the array to be ReAlloc()ed.
+
+ 2) Speeded up TInt64 multiply a bit more on the ARM.
+
+ 3) Added a mechanism whereby every DFC knows whether or not it is pending. Kern::Add
+ will now only queue the DFC if it is not already queued. DFCs are flagged unqueued
+ just before being run. A Queued() function is provided to discover whether a DFC
+ is currently queued or not, and a Cancel() function is provided to cancel a DFC
+ which is currently pending.
+
+ 4) Added missing break statements to case EConsoleSetTitle and case EConsoleSetSize
+ in ws_main.cpp
+
+ 5) Fixed bug in KBARM\BOOTROM1.S and KBSARM\BOOTROM1.S where a register was being
+ corrupted (subroutine WordMove corrupts r3) leading to the kernel BSS section not
+ being correctly zeroed on reset.
+
+ 6) Fixed bug in TInt64::GetTReal() ARM machine code version - wrong shift count in one
+ instruction.
+
+ 7) Added new function KFormat() to KS_UTL.CPP to do limited printf-style formatting
+ without using any EXEC calls. Modified Kern::Printf to use this function instead
+ of TDes::AppendFormatList(). This enables Kern::Printf to be used in fast exec
+ calls, interrupts etc. Use a static buffer to receive the formatted string instead
+ of an automatic one to avoid gobbling a large amount of stack.
+
+ 8) Added a new flag ExecMutateFlag which is set by the IRQ and FIQ dispatchers if
+ an interrupt occurs in SVC mode. The fast executive dispatcher tests this flag on
+ return from the exec function and if it is set, DFCs and/or a reschedule will be
+ executed in the same way as for a slow exec call. This fills a hole in the interrupt
+ scheme whereby if an FIQ occurred during a fast executive call and queued a DFC,
+ the DFC would not be run before user code was resumed. This flag can also be set
+ by a fast executive call in order to allow rescheduling to occur.
+
+ 9) Changed some executive calls from slow to fast to reduce overhead in the case where
+ a reschedule is not needed. These are ChunkBase, ChunkSize, ChunkBottom, ChunkTop,
+ ChunkMaxSize, MutexCount, MutexWait, MutexSignal, ProcessId, ProcessExitReason,
+ ProcessExitType, ProcessExitCategory, ProcessPriority, ProcessFlags, SemaphoreCount,
+ SemaphoreWait, SemaphoreSignal1, ServerReceive, SessionSend, ThreadId,
+ ThreadPriority, ThreadProcessPriority, ThreadFlags, ThreadExitType, ThreadExitReason,
+ ThreadExitCategory, ThreadRequestCount, ThreadRequestComplete, WaitForAnyRequest
+ and SvSendReceive.
+
+ 10) Use a different stack for IRQs (IrqStack) rather than the reentrant stack. This
+ allows IRQs to be enabled during a fast executive call. ThreadRequestComplete,
+ SessionSend, SvSendReceive, ServerReceive enable IRQs during their execution.
+
+ 11) Modified the exception handling mechanism. All exceptions are now placed into
+ one of three categories:
+
+ Fatal (exceptions in IRQ, FIQ or ABT mode) - these always cause a kernel fault
+ Critical (SVC mode or UND mode with the kernel locked) - these cause a kernel
+ fault unless exception trapping is enabled (DThread::iExceptionErrorCode)
+ Noncritical (user mode or UND mode with the kernel unlocked) - these are handled by
+ exception trapping, thread exception handler, global exception handler
+ in that order. If none of these is active, the current thread is paniced,
+ and if that thread has the system flag set a kernel fault results.
+
+ 12) If an exception occurs while the kernel is locked, DFCs will not be run at the end
+ of the exception handler.
+
+ 13) PD Variant::Init3() now sets CS1 ROM size to 4Mb and total ROM size to 8Mb.
+
+
+2) Morgan
+ 1) Renamed Dll::Data to Dll::InitialiseData()
+ 2) Fixed zeroing bss for Dll data in ROM
+
+
+Version 1.02.120
+================
+(Made by Jonathan, 24th Nov 1997)
+
+1) Pete
+ A) Various changes to PC Card Controller to fully support I/O cards as well as memory cards:-
+
+ 1) Added a new (exported) PC card controller function -
+ TInt DPcCardCntrl::RestoreCardPower(TSocket aSocket, TInt aResetProfile).
+ This re-applies power to a PC Card which has previously been successfully powered by the system.
+ If a media change has occurred on the socket since it was last powered then function will
+ immediately return KErrGeneral. The power up process is the same as carried out by the controller
+ function PowerUpCard() - wait up to 2.5Secs for card to become ready using specified reset
+ profile. However, this function doesn't implement a TRequestStatus mechanism when complete.
+ It is left to the caller to poll the card status. If the card had previously been configured when
+ powered and the configuration options allow the configuration to be restored (see 3) then the
+ card will be reconfigured automatically when it is re-powered.
+ 2) Modified the PC card controller function DPcCardCntrl::PowerUpCard() so that, like RestoreCardPower()
+ it re-configures PC cards which were previously configured when the card was powered down if a media
+ change hasn't happened since. Also, the optional last parameter (was TInt aResetLen, now TInt
+ aResetProfile) now specifies both the reset length and a pause after the card becomes ready. The upper
+ 16bit word specifies a pause period (in 20mS units) after the card signals it is ready before the
+ controller updates the socket status (and TRequestStatus is signalled). The lower 16bit word specified
+ the length of the reset pulse (also in 20mS units) applied to the card.
+ 3) Added a new version of the PC card controller function DPcCardCntrl::RequestConfig(). The new
+ version has an additional parameter 'TUint aFlag' (the old version is now obsolete). The only
+ flag currently defined is 'KPccdConfigRestorable' which is set if the config may be restored
+ automatically by the controller if the card is re-powered (see 1 and 2).
+ 4) Added new values to TPccdSocketStatus (to support 1,2 and 14). This can now have the following
+ values:-
+ - ESocketFullyOff: Card not present or present but not yet powered.
+ - ESocketPoweredDown: Card present, not currently powered but has been powered
+ and could be restored to previous configuration (ie no media change
+ since it was last powered).
+ - ESocketBatTooLow: Card present, but not currently powered. A previous attempt to
+ power the card failed because the main battery voltage was too low.
+ - ESocketNotReset: Card present and powered, waiting for it to become ready.
+ - ESocketReady: Card present, powered and ready.
+ - ESocketCorruptCard: Card present but not powered since it cannot be recognised by
+ controller (not used yet).
+ 5) Changed the PC card controller event type that causes the mount status of TLocalDrive objects
+ (associated with PC card media) to be updated. Before, the status was updated on a power-up
+ event (EPccdEvPwrUp) meaning that any subsequent access to the TLocalDrive object would
+ be preceded by a remount. Having it on power-up rather than power-down meant the media drive
+ system only had to bind to one event rather than EPccdEvPwrDown and EPccdEvEmergencyPwrDown.
+ This however meant it was not possible to power-down cards during periods of inactivity. The
+ media drive system now binds to power-down events.
+ 6) Change to ATA media driver (MEDATA) on ARM architectures brought about by the emergency power
+ down changes in E32-V115. The driver was bound to the PC card controller emergency power down
+ event. Since the driver's event callback is now called on a DFC, changes have been necessary
+ to handle card writes aborted by emergency power down.
+ 7) Added a new (exported) PC card controller function -
+ TInt DPcCardCntrl::SetEvent(TSocket aSocket, TPccdEvent anEvent, TInt anInfo);
+ This allows drivers etc to generate PC card events. It also allows extra info to be passed to
+ callback functions via 'anInfo' (see 8 below).
+ 8) TPccdCallBack has an extra member 'TInt iCallBackInfo' which can be used to provide extra info.
+ on a PC card controller event. Extra info on the reason for card power down is now provided in
+ iCallBackInfo for EPccdEvPwrDown events.
+ 9) The following functions have been added to the custom DLL:-
+ TPtrC PcCardMediaChangeIntSource(TInt aMediaChange)
+ void ClearPcCardMediaChangeInt(TInt aMediaChange)
+ TMediaState PcCardMediaState(TInt aMediaChange);
+ Prior to these changes the PC card controller media change implementation was completely
+ implemented in the architecture level and above, meaning that variations to the media change
+ system couldn't be handled without a new architecture.
+ Also added an additional member 'TInt iMediaDoorCloseDelay' to 'TPccdCntrlMachineInfo' (returned by the
+ custom function PcCardMachineInfo()) which allows the media door switch de-bounce parameter to be specified
+ in the custom.
+ 10) Support for dual voltage PC Card sockets added. These are sockets where the VCC voltage can be
+ altered depending on the type of card detected (typically 3.3V or 5V). The system implemented,
+ initially sets the socket VCC depending on the voltage setting indicated by the cards VS (voltage sense)
+ signals. Dynamically changing the socket VCC once the card is powered (in response to information in
+ a card's CIS etc) is not supported.
+ 11) Added a new (exported) PC card controller function -
+ TPccdSocketVcc DPcCardCntrl::SocketVcc(TSocket aSocket);
+ This returns the current VCC setting for the specified socket. Note that this function
+ returns info on its current VCC setting even when the supply is turned off.
+ 12) Generally tidy up of the ARM PC card controller VCC implementation. Additions of the following
+ function to custom DLL:-
+ PcCardVccInfo(TInt aPsu,TPccdCntrlVccInfo &aninfo).
+ TPccdCntrlVccInfo is defined:-
+ class TPccdCntrlVccInfo
+ {
+ public:
+ TUint iVoltageSupported;
+ TInt iMaxCurrentInMicroAmps;
+ TUint iVoltCheckInterval;
+ TPccdPsuVoltChkMthd iVoltCheckMethod;
+ };
+ This specifies the voltage(s) that the supply supports (5V,3.3V etc), the maximum current
+ it can supply, when the o/p of the supply should be checked (once when first turned on,
+ or continuously while on) and how the voltage should be check (via the ADC channel reserved
+ for the PC card controller or via a variant layer function).
+ 13) TPcCardPsu renamed to TPcCardVcc since it now has functionality which could
+ only be attributed to a VCC supply (eg 10&12 above) rather than a generic PC Card supply.
+ 14) Added an additional member 'TInt iDisableOnLowBattery' to 'TPccdCntrlMachineInfo' (returned by the
+ custom function PcCardMachineInfo()). This can be used to set a battery level (see TSupplyStatus) such that
+ if the main battery level is below this level, the PC card controller will no longer power up
+ any PC cards. Set to EZero to disable this feature.
+ 15) Fixed problem clearing PC Card IREQ interrupts on ARM. On ARM platforms the PC card controller
+ IREQ interrupt service routine was clearing the interrupt in the controller hardware (ETNA)
+ before calling any ISRs bound by drivers. Since it is generally the driver ISR which clears
+ the source of the interrupt on the card you end up with a second bogus IREQ interrupt. This
+ only occurs when 'level mode' interrupts are enabled, not 'pulse mode'. Pulse mode interrupts
+ are selected if supported which is why the problem was only discovered so late in the day.
+ 16) Changed the reset timing when powering up a PC card. Now:- Apply reset for 100mS, wait up to 2.5Seconds
+ for card to become ready, delay any access to the card for a further 100mS after ready. (Was:- apply reset
+ for 60mS, wait 2.5Seconds for ready and no delay on subsequent access).
+ 17) Fixed problem in PC card serial port PDD where the destructor could be called before the member
+ 'iSocket' was initiated. The destructor calls PcCardCntrl::PowerDownCard(iSocket). This was
+ a particular problem on rack D where the PC card socket is socket 1 (CF card socket is socket 0)
+ and the rack hw doesn't fully isolate the two sockets. Certain comms programs attempt to open a channel
+ on the PC card serial port while a channel is already open on this device. These subsequent attempts fail
+ calling the PDD destructor which then was incorrectly powering off the wrong socket. Due to the h/w
+ implementation, this was actually resulting in the serial PC card being reset.
+ 18) Fixed a problem affecting EXTFIQ. Once you bound a TInterrupt to EXTFIQ it was not possible to unbind
+ again.
+ 19) Added the following test programs to TPCCD:-
+ i)T_MEDCH (and associated LDD MEDCH.LDD): Soak test of Compact Flash (ATA) - h/w media changes.
+ ii)T_EXTFIQ (and associated LDD EXTFIQ.LDD): Continuously generates EXTFIQ on rack D using EXTFIQ.LDD.
+ iii)T_BEXFIQ (and associated LDD BEXFIQ.LDD): Generates EXTFIQ on rack D, associated LDD binds and clears
+ FIQ.
+ Also modified DRVSOAK to better support emergency power down testing.
+
+ B) Modification to serial comms in order to support PC card serial devices:-
+
+ 20) Added mechanism for opening a channel on a PC Card I/O device. These devices requires an asynchronous
+ power-up of the card before the standard channel open mechanism can take place. In the case of some PC
+ Cards (e.g. Serial port cards) there needs to be a further asynchronous phase after creating the PDD
+ before the channel is fully open.
+ Added a kernel slow exec function:-
+ TInt RLogicalChannel::CheckOpenMode(const TDesC &aLogicalDevice,const TVersion &aVer,TInt aUnit);
+ This is called once each time a channel is opened. If the return value is <0 then the open proceeds as
+ normal. Otherwise, it indicates that a 1 or 2 phase asynchronous open is required. (This function would
+ normally ripple down to the custom DLL).
+ Added a kernel supervisor function:-
+ TInt RLogicalChannel::DoSlowOpen(TInt aMode,TInt anInfo,TRequestStatus &aStatus);
+ This initiates the asynchronous parts of the operation. 'aMode' is either KChanSlowOpenPhase1 or
+ KChanSlowOpenPhase1 to indicate whether its the aynchronous phase before or after the normal open. 'anInfo'
+ is derived from the value returned from CheckOpenMode() and normally indicates the PC Card socket in
+ question. TInt RLogicalChannel::DoCreate() has been modified to include these extra operations.
+ An extra pure virtual function:-
+ TInt DComm::CompleteSlowOpen(DThread *aThread,TRequestStatus *aReqStat);
+ had to be added to DComm in order to implement the 2nd asynchronous open phase.
+ 21) Modified PC card serial port PDD to take advantage of the above PDD open scheme (20) so that the PDD now
+ fully controls the PC card. (Before it relied on the media system having already powered up the PC Card and
+ didn't properly perform the 2nd part of the initialisation). Also modified the PDD so that it re-applies
+ power and re-configures the Serial PC Card each time the system comes out of standby (eg machine switched
+ off, emergency power down etc).
+ 22) Changes to LDD to handle PC Card media change events (ie media door open or card removal - dependant on
+ platform).
+ As far as I can gather, in the serial LDD, iStatus==EClosed never occurs. I now force the LDD into
+ this state from a PC Card PDD when a media change is detected. The serial port now needs to be disabled
+ (for good) because it has been powered down (and in all likelyhood removed). Once in this state
+ you never should to change to any other state. Any write requests return with KErrNotReady which hopefully
+ will give any client a clue that they shouldn't have removed the PC card serial port while using it. This
+ is an intermediate solution. The eventual plan (involving a the invention of a new RDevCom type class) will
+ handle the media change and re-power the serial PC card (if still there) before any requests get down to
+ the LDD. However, you need an asychronous supervisor kernel call to restore a PC card after media change
+ which can't be acheived with the present scheme. It is possible to re-power the PC card when coming out of
+ standby (machine turned off etc) because you know the same PC card is still present and hence you don't
+ need to alter any memory allocation associated with the card.
+ 23) Modified PC card serial port PDD to enable serial interrupts for modem signal status changes (CTS,DCD,DSR,
+ RI). Prior to this, h/w flow control wasn't supported on this serial device.
+ 24) Modified PC card serial port PDD to update system current consumption info. This info is derived from the
+ PC card CIS where possible.
+ 25) Modified PC card serial port PDD to determine its baudrate capabilities from 'max baudrate supported' field
+ (if present) in the CIS. Also, limit baudrate (capabilities) to 19200 if serial card doesn't contain a FIFO.
+ 26) Added the following test programs to TCOMM:-
+ i)T_MODEM1: Test code for PC Card Modem Serial Ports (analogue loopback).
+ ii)T_COMSOAK1: Serial port soak test program (requires loopback connector).
+ iii)T_AMPV: Approval test code for PC Card Adapter.
+ iv) T_MODEM2: T_SERIAL for PC card serial port. Instead of looping COM1 to COM2(Etna) it loops
+ COM1 to COM3 expecting a PC Card Socket I/O Serial card.
+ Also modified T_TERM so it can be used to open a channel on COM3. (Also added extra error reporting).
+
+2) Jonathan
+ 1) Old Snowball variant SA retired.
+ 2) New Snowball variant S1 for Prototype 3 units. Major changes from SB:
+ - Combined PDD for Eiger and ASIC serial ports using shared modem
+ status interrupt.
+ - Variant-specific LDD for use on ASIC serial port only - implements
+ Spark phone's weird CTS handshaking.
+ - QuickEmergencyStandby handler.
+ 3) New PhysicalScreenWidth and PhysicalScreenHeight values for
+ \epoc32\data\system.ini, see kpwins\kp_gui.cpp .
+ 4) Prevented *\va_sdrv.cpp from trying to Disable or UnBind when unbound
+ from its interrupt.
+
+
+Version 1.02.119
+================
+(Made by Morgan, 7th Nov 1997)
+
+1) Alastair
+ 1) SARM
+ Integrated Single-process code into e32 source allowing SARM roms to be
+ created. Build commands are mnt sarm, sarmall, sarmrel etc. There are no
+ releaseables and no facilities for building test programs. SARM builds
+ use the "__SINGLE__" macro for distinguishing Single-process-specific
+ code. Work directories are \epoc32\build\e32\sarm\[build] and
+ \epoc32\release\sarm\[build]. SARM makefiles are generated into
+ \e32\bsarm using perl to process makefiles from \e32\bmarm as a
+ temporary measure prior to the use of makmake for creating e32
+ makefiles. SARM roms are built from directory \e32\kbsarm, and require
+ a special version of rombuild - the makefile for this special version
+ will be released with e32tools version 082.
+
+ Major changes
+ a) \e32\kbsarm - contains special versions of bootrom1.s and rom.oby.
+
+ b) \e32\inc - changes to e32rom.h, k32std.h, m32mmu.h, m32std.h and
+ v32eiger.h so that different linear address constants are defined
+ for __SINGLE__ builds.
+
+ __SINGLE__ (MULTI)
+ KRomHeaderLinAddr 0x00000000 0x50000000
+ KSuperPageLinAddr 0xC0000000 0x40000000
+ KHomeBase 0xC0000000 0x80000000
+ KHomeEnd KHomebase+0x3fffff 0xffffffff
+ KHwLinBase 0xa0000000 0x60000000
+ KHwLinEnd 0xbfffffff 0x7fffffff
+ KEigerBaseAddress 0x80000000 0x58000000
+
+ c) \e32\kpepoc\kp_chk.cpp - __SINGLE__ chunks are allocated in the kernel's
+ heap - they cannot change in size and don't move. Since SARM roms do not
+ utilise the MMU. The actual size of a chunk is a compromise between the
+ initial and maximum sizes requested when a chunk is created.
+
+ File changes
+ d) bsarm\*
+ dpepoc\d_medint
+ group\mnt.cmd
+ inc\ - e32rom.h, k32std.h, m32mmu.h, m32std.h, v32eiger.h
+ kbsarm\*
+ kearm\ - ke_ini, ke_int, ke_mmu, ke_utl
+ kpehal\ - kph_inf, kph_pic
+ kpemmu\ - kpm_mmu.cpp
+ kpepoc\ - kp_chk, kp_ini, kp_proc, kp_reg, kp_std.h, kp_thrd, kp_utl
+ ksrc\ - ks_svr, ks_utl
+ varmpd\va_hw
+ wsrc\wd_eiger
+
+ 2) Added UNICODE.H to e32\inc\incc.prj so that the file is released.
+
+ 3) Changed WINS command line processing such that only switches specified
+ before "--" is encountered are processed. Switches after the "--" switch,
+ or all switches if the "--" switch is not specified, are ignored.
+
+ 4) Added -L<language Index> switch to WINS command line so that
+ different Epoc locales can be specified. Eg "WSEXE -L5 --" will
+ mean that elocl5.dll rather than elocl.dll is loaded.
+
+2) Dennis
+ 1) Rewrote MMU code. Major changes are:
+ i) Linear address map has changed - see file KEARM\KE_MMU.CPP
+ ii) RAM drive is at fixed linear address but no longer composed of consecutive
+ physical RAM pages.
+ iii) The free page pool has been removed.
+ iv) The ROM is mapped with section descriptors on the ARM instead of 4K pages.
+ v) Chunks can be adjusted in place rather than only in the home section.
+ vi) On the ARM extra protection has been added for page tables, registry
+ and RAM drive.
+ vii) ROM layout is different - the kernel data is at 80000000, followed by
+ static data for fixed-address ROM processes (see below). The kernel
+ stack follows the last fixed-address data chunk, and the home section
+ starts with the kernel stack chunk.
+
+ 2) Modified process handling and scheduling:
+ i) Now have two classes of process. One class has its chunks mapped down
+ into the data section while running, the other class has its chunks
+ at the same linear address all the time. The latter class is used for
+ system servers. It reduces the need for cache flushing - this is only
+ required if any chunks have moved - and thus gives a considerable speed
+ increase.
+ ii) ROM fixed address processes specified in .OBY file
+ RAM fixed address processes specified by setting KImageFixedAddressExe flag
+ iii) On the ARM, a domain will be allocated to every fixed-address process.
+ All the process' local chunks will be located in this domain. In addition,
+ every global chunk created by a fixed-address process will be allocated
+ a domain. The use of domains removes the need for page directory
+ manipulation when switching between these processes.
+ iv) The scheduler has been machine coded for ARM and ISA. Actions performed
+ on switching between processes now depend on the attributes of these
+ processes.
+
+ 3) Added ARM machine coded message passing and semaphore code.
+
+ 4) Modified inter-process reading and writing code. Two functions have been added:
+ i) TAny* DPlatThread::CurrentAddress(TAny *anAddress);
+ This function returns the current linear address corresponding to an
+ address in the thread's address space. No translation is done for addresses
+ above 0x40000000 or if the thread's process is currently running.
+ This function is used to convert addresses for reading.
+ ii) TAny* DPlatThread::CurrentAddress(TAny *anAddress, TInt& aMaxSize);
+ This function returns the current linear address corresponding to an
+ address in the thread's address space and also the maximum size of a write
+ to the thread's address space (end of chunk - specified address).
+ Chunk lookup is always performed.
+ This function is used to convert addresses for writing.
+
+ 5) Kernel faults now restart the system from the reset vector. The MMU backup
+ page has been removed.
+
+ 6) Added double-ended chunks. These are regions of memory where the committed
+ region can start at any address in the reserved range, rather than always starting
+ at the base of the reserved range. Added functions
+ i) RChunk::CreateDoubleEndedLocal()
+ Create a local double-ended chunk with a specified maximum size and
+ a specified initial committed region.
+ ii) RChunk::CreateDoubleEndedGlobal()
+ Create a global named double-ended chunk with a specified maximum size and
+ a specified initial committed region.
+ iii) RChunk::AdjustDoubleEnded()
+ Adjust the position and/or size of the committed region. If the initial
+ and final regions intersect, the contents of the intersection are
+ unchanged. Other parts of the committed region have undefined contents.
+ iv) RChunk::Bottom()
+ Returns the offset of the base of the committed region from the base of
+ the reserved region (RChunk::Base()).
+ v) RChunk::Top()
+ Returns the offset of the top of the committed region from the base of
+ the reserved region. ( Top() = Bottom()+Size() )
+ RChunk::Size() always returns the size of the committed region.
+
+ 7) Extended the CBitMapAllocator class. Functions added are:
+ i) TInt Alloc(TInt aCount, TInt& aConsecutive)
+ Allocates from the first free position as many consecutive positions as
+ possible, up to aCount. Returns the first free position, and aConsecutive
+ equal to the number of positions allocated.
+ ii) TInt AllocAligned(TInt anAlignment)
+ Allocates a position whose number is an exact multiple of 2^anAlignment.
+ iii) TInt AllocAlignedBlock(TInt anAlignment)
+ Allocates a block of 2^anAlignment consecutive positions such that the
+ first position is an exact multiple of 2^anAlignment. Returns the
+ first position.
+ iv) AllocAt(TInt aPos, TInt aCount)
+ Allocates aCount positions starting at aPos.
+ v) Free(TInt aPos, TInt aCount)
+ Frees aCount positions starting at aPos.
+ iv) TBool IsFree(TInt aPos, TInt aCount)
+ Returns TRUE if and only if positions [aPos,aPos+aCount) are all free.
+
+ 8) Modified Math::Sin, Math::Cos and Math::Tan functions to return exact answers
+ when input values are exact multiples of pi/2. This is done by adding tests of
+ the form
+ IF ( ABS(x MOD pi) < 2^-52 * ABS(x) )
+ return exact answer
+ ELSE
+ do calculation as before
+ ENDIF
+
+ 9) Modified TTime::Convert(const TDateTime&) and TTime::DateTime() in order
+ to minimise the number of divisions involved and to use 32 bit arithmetic
+ rather than 64 bit wherever possible. The latter of these functions gets
+ called frequently by the window server on a periodic timer.
+
+ 10) Added functions TDes8/TDes16 :: (Append)NumFixedWidth(UC)
+ These convert 32-bit integers to descriptors in a specified radix, adding leading
+ zeros up to the specified field width. These are intended to replace calls of
+ the form
+ des.Format(_L("%08x"),value)
+ which are very inefficient. All Format() calls in E32 have been replaced, apart
+ from the ones which use an overflow handler.
+
+ 11) Fixed problem with comms driver causing reset if an interrupt occurs while the
+ kernel server is closing a comms channel. This was caused by the interrupt queuing
+ a DFC which refers to the comms channel being closed. The DFC runs after the
+ kernel server has deleted the channel, and resets the machine when it tries to
+ access the nonexistent channel.
+
+ 12) Files changed:
+ dcomm\ d_comm.cpp
+ dpepoc\ d_medint.cpp
+ dvideo\ ws_disp.cpp
+ inc\ e32base.h, e32des8.h, e32des16.h, e32rom.h, e32std.h, e32svr.h,
+ k32std.h, k32std.inl, m32std.h, m32std.inl, m32hal.h, u32std.h, v32eiger.h
+ m32mmu.h and m32mmu.inl have been removed
+ kbarm\ bootrom1.s, rom.oby
+ kbx86\ boot486.asm, bootrom.asm, build.cmd, e32d.oby, e32r.oby, m486.bat,
+ romdefs.inc, romhead.inc
+ kbsarm\ bootrom1.s
+ kearm\ ke_dat.cpp, ke_dbg.cpp, ke_ini.cpp, ke_int.cpp, ke_mmu.cpp, ke_pccd.cpp,
+ ke_pic.cpp, ke_psu.cpp, ke_std.h, ke_thrd.cpp, ke_utl.cpp
+ ke_all.cpp deleted, ke_sched.cpp added
+ keisa\ ke_dat.cpp, ke_dbg.cpp, ke_ini.cpp, ke_int.cpp, ke_mmu.cpp, ke_pccd.cpp,
+ ke_std.h, ke_thrd.cpp, ke_utl.cpp
+ ke_all.cpp deleted, ke_sched.cpp added
+ kex86\ ke_exc.cpp, ke_ini.cpp, ke_int.cpp, ke_mmu.cpp, ke_std.h, ke_thrd.cpp,
+ ke_utl.cpp
+ ke_all.cpp deleted
+ kpehal\ kph_dbg.cpp, kph_inf.cpp, kph_pic.cpp
+ kpemmu\ kpm_mmu.cpp
+ kpm_all.cpp, kpm_regn.cpp, kpm_sect.cpp deleted
+ kpepoc\ kp_chk.cpp, kp_dat.cpp, kp_dev.cpp, kp_ini.cpp, kp_proc.cpp, kp_reg.cpp,
+ kp_sched.cpp, kp_sem.cpp, kp_thrd.cpp, kp_utl.cpp
+ kpwins\ kp_chk.cpp, kp_ini.cpp, kp_proc.cpp, kp_std.h, kp_thrd.cpp, kp_utl.cpp
+ ksrc\ ks_chk.cpp, ks_exec.cpp, ks_ldd.cpp, ks_lib.cpp, ks_mes.cpp, ks_pdd.cpp,
+ ks_proc.cpp, ks_svr.cpp, ks_thrd.cpp, ks_utl.cpp
+ ubas\ ub_bma.cpp, ub_obj.cpp, ub_std.h
+ ucdt\ uc_des8.cpp, uc_des16.cpp, uc_exec.cpp, uc_func.cpp, uc_ksvr.cpp,
+ uc_reg.cpp, uc_std.h, uc_time.cpp
+ umath\ um_rtod.cpp, um_sin.cpp, um_tan.cpp
+ upmarm\ up_des8.cpp, up_exec.cpp, up_utl.cpp
+ upmx86\ up_exec.cpp
+ upwins\ up_exec.cpp
+ vx86pc\ vx_vga.cpp
+
+
+3) Morgan
+ 1) Added dll process attach and detach for ARM and X86 builds
+ 2) Added RThread::Context(TDes8 &aDes) to retrieve the register contents of
+ a sleeping thread.
+ 3) Added RChunk::ReserveAt(TUint8 *) to force allocation of a chunk at the
+ specified linear address.
+ 4) Ldd/Pdds with static data was broken. Now fixed.
+ 5) Loading Dlls with writable static data now allocates a Data/Bss chunk
+ and offers it to F32 to be fixed up.
+ 6) Added TInt Dll::Data() to initialise Dll writable static data
+
+
+Version 1.02.118
+================
+(Made by Jonathan, 15th October 1997)
+
+1) Dennis
+ 1) Rewrote CObjectIx, CObjectCon and CObjectConIx classes to do their own
+ array handling instead of using CArrayFixFlat.
+
+ 2) Added ARM machine-coded versions of CObjectIx::At, CObjectIx::operator[],
+ CObjectCon::At and CObjectCon::operator[].
+
+ 3) Added ARM machine-coded versions of CActiveScheduler::Start() and
+ CServer::RunL().
+
+ 4) Removed CArrayFixFlat from DPlatProcess. Custom array handling code is now
+ used to store the chunks being used by a process.
+
+ 5) Added ARM machine-coded versions of some commonly used fast Exec:: calls and
+ of DPlatProcess::LookupChunk().
+
+2) Morgan
+ 1) Added -M<machineName> switch to WINS command line to pick up
+ alternate System ini files from \epoc32\Data. eg WSEXE -Mfungus
+ will use \epoc32\data\fungus.ini
+ 2) Froze the Custom Dll against V1.01 E32(114)
+ 3) Froze the Variant Dlls (P1,P2,PB,PC,PD,PG,SA,SB,CL) against V1.01 E32(114)
+
+3) Jonathan
+ 1) Changed Snowball A & B physical screen size to 4.4"x1.375".
+ 2) New TSAsic::SetCrystalSpeed function in varmsb\va_sasic.cpp.
+ 3) Added cakysbd keyboard driver for Snowball B which has a, b, z and :
+ instead of arrow keys.
+ 4) Snowball B variant autodetects 4MB or 8MB ROM, 1MB or 4MB RAM
+ 5) New Hal::StartupReason() type EStartupSafeReset. Currently this is only
+ returned by Snowballs when "Home" and "Back" are pressed at boot.
+ 6) Replaced Variant::ColdReset with more general Variant::StartupReason.
+ This breaks Morgan's variant & custom freezes against 114 for this one
+ function, but that's OK because the kernel really is the only component
+ that should be calling this.
+ 7) New UserSvr::ResetMachine(TMachineStartupType) function. Currently only
+ allows a reset type of EStartupWarmReset. Implemented by generating a
+ TPlatFault::ESoftwareWarmReset. After the reset the kernel may
+ actually report a reason other than EStartupWarmReset if either:
+ - EStartupWarmReset isn't supported (mx86/misa/wins)
+ - The variant supports munging of reset types, ie by holding down
+ keys at boot, and those keys are held down (various marm variants).
+ 8) New custom and parent functions AutoSwitchOffType, which returns
+ ESwitchOffEvent on Snowballs A & B, ESwitchOffHard on other variants.
+ 9) New TRawEvent::ESwitchOff. The kernel generates this at auto-switchoff
+ time instead of just switching off if the above function returns
+ ESwitchOffEvent. The window server (or one of its clients) must call
+ UserHal::SwitchOff fairly soon after receiving this event. Made the
+ text window server do this. Auto-switchoff is still disabled by default
+ on Snowballs A & B becuase wakeup is still broken.
+
+
+4) Matthew
+ 1) Enabled hardware filtering on SA and SB digitisers. Also boosted
+ sampling rate to 112 pps.
+
+ 2) Changed SB variant so that the san-disk is mapped to InternalMedia0
+ (ie C:). Make sure you get rid of MEDINT.PDD from your .oby file when
+ building roms, or F32 will pick this up and you will still have the
+ ram disk as C:.
+
+
+Version 1.02.117
+================
+(Made by Jonathan, 5th September 1997)
+
+1) Dennis
+ 1) Rewrote Math:: transcendental functions to use simpler algorithms
+ and to run faster. All functions now use polynomial approximations
+ instead of rational functions.
+
+ 2) Added Math::PolyX function to do fast polynomial evaluation using
+ TRealX for argument, coefficients and result.
+
+ 3) Updated T_R64BM to benchmark more functions and to use a range of
+ different argument values.
+
+ 4) Added new test program T_MATH2.EXE to test the accuracy of the
+ transcendental functions.
+
+ 5) Fixed SW-21.
+ Changed way in which DLLs statically linked to an EXE are handled.
+ Instead of opening a process-relative handle on the DLL, the process'
+ code chunk now holds a list of DLLs on which it depends. This list
+ is only deleted when the chunk itself is deleted, thus solving the
+ problem of two instances of the same EXE running concurrently.
+ Added function UserSvr::ExeAddDependency to add a DLL to the process
+ code chunk's dependency list.
+
+2) Matthew
+ 1) Added software filtering to Snowball digitiser drivers.
+
+ 2) Moved initial calibration of digitiser into the TDigitiserXxx::Init3().
+ This has also meant that some of the E2Prom functions needed to be
+ exported - I exported all the public functions.
+ This change has allowed Hal::Init3 to be rearranged to how it was in 114.
+
+ 3) Fixed small bug in Snowball B Comm2 driver, which was acting as though
+ it supported 57600bps.
+
+3) Rob Pym
+ 1) Added support for ARM 7115 - this chip has a few more peripherals
+ than the ARM 7110. New functions in ke_eiger.cpp and ke_pic.cpp.
+
+ 2) Added CL variant for the Cirrus Logic ARM 7115 evaluation board.
+ [Jonathan:] Releasables not released because it doesn't build.
+
+
+Version 1.02.116
+================
+(Made by Jonathan, 26th August 1997)
+
+1) Dennis
+ 1) Added new extended-precision real class TRealX, defined in
+ e32math.h. This class provides 64 bit precision and a dynamic
+ range of approx. 1E-9863 to 1E+9863. All member functions are
+ assembler coded for speed.
+
+ 2) Changed GCC compiler helper functions to use TRealX instead
+ of TReal96 to speed things up. Also modified all UM_xxx files
+ to use TRealX instead of TReal96, apart from UM_DTOR and
+ UM_RTOD.
+
+ 3) Added new test programs T_TREALX, T_R64BM, T_RXBM. T_TREALX
+ tests the TRealX member functions. T_R64BM does a benchmark
+ test for TReal64 field operations and transcendental functions.
+ T_RXBM does a benchmark test for TRealX field operations.
+
+ 4) Added machine coded versions of Math::Sqrt() and some other
+ Math:: functions for ARM.
+
+2) Jonathan
+ 1) Fixed data TX on varmsa/va_com2.cpp and varmpd/va_com3.cpp when
+ Fifos are disabled; no longer trys to output >1 byte on TX interrupt.
+
+ 2) Variant::Init3() on Snowball A & B sets AutoSwitchOffBehavior to
+ ESwitchOffDisabled because power management isn't yet implemented.
+
+ 3) Changed table in Snowball B Variant::SetLcdContrast to correct for
+ strange hardware.
+
+ 4) To reduce noise in the output logs, all .cmd files to build E32 now
+ invoke NMAKE with the -nologo flag.
+
+3) Pete
+ 1) Added Internal ATA media driver (MATISB.PDD) for Lavender prototype B
+ build.
+
+ 2) Change to internal ram media driver on WINS/ARM so that it only
+ opens on media device type EFixedMedia0 rather than any fixed media
+ type.
+
+4) Matthew
+ 1) Fixed bug in Snowball digitiser drivers which caused execeptions when
+ the pen was down. Fixed by moving the queueing of the pen-up timer from
+ the interrupt service routine into the Dfc.
+
+ 2) Added code to read the CTS signal in the Snowball prototype B com2 PDD.
+
+ 3) Temporarilly made the Snowball prototype B com2 PDD ignore framing
+ errors at 38400 bps. This is to allow people downstream to use the port.
+
+ 4) Further modifications to T_SERIAL for Snowball compatibility.
+
+Version 1.02.115
+================
+(Made by Jonathan, 16th August 1997)
+
+1) Graham
+ 1) Changed in RAM standby code to have a delay loop
+ rather than the previous faulty inmplementation
+ which attempted to validate the ROM by
+ continually reading it until it returned a known
+ good value - this was erroneous because the ROM
+ reads were coming from the cache anyway.
+
+ Then I commented out this code and replaced it with
+ the traditional code that runs from ROM (this was
+ only introduced as a result of some hardware paranoia
+ when we were getting 'unable to switch on' bugs in
+ the run up to V1.00
+
+ 2) Updated minor version number to 02.
+
+2) Dennis
+ 1) Modified emergency power-down FIQ handler so that it
+ only performs the bare minimum of tasks when the machine
+ is powered up again. Other more time-consuming tasks have
+ been moved into a DFC.
+
+ 2) Added new machine code versions of TInt64 functions for MARM,
+ WINS and MX86 which don't use the TInt64A class.
+
+ 3) Added machine coded versions of some 8-bit descriptor functions
+ for MARM in new file UPMARM\UP_DES8.CPP.
+
+ 4) Added machine coded versions of RHeap::Alloc(), RHeap::Free()
+ for MARM REL.
+
+ 5) Modified Mem::Copy() to run faster when source and destination
+ addresses are unaligned, or when a small copy is required.
+
+3) Ann
+ 1) Fixed rounding bug where the number of intervening zeros
+ after the decimal point in a descriptor was being ignored
+ when next non-zero digit is out of range of precision when
+ converting to real.
+
+4) Matthew/Jonathan
+ 1) Added Snowball B variant for use with the Snowball prototype.
+
+ 2) With a TSAsic class to access the ASIC on the Snowball prototype.
+
+5) Matthew
+ 1) Added digitiser drivers for snowballs A and B.
+
+ 2) Added a virtual SetCalibration() function to the TXYInput
+ class, so that future digitiser drivers can use hardware
+ calibration, if this is available.
+ Currently none of the drivers use this (including the Snowball
+ ones) and they return KErrNotSupported.
+
+ 3) Added a comm pdd for the Snowball prototype asic. There are
+ several known bugs in this driver.
+ Made some modifications to T_SERIAL so that it does not test
+ things beyond the capabilities of the comm port when running
+ on a Snowball.
+
+6) Jonathan
+ 1) Fixed problem caused by reading IID register too often in
+ Snowball A 2nd comm pdd.
+ 2) Added IR support to Snowball B 1st comm pdd (untested).
+
+ Failing on Snowball B prototype:
+ - tests t_power, t_timer, t_chunk, t_serial, t_idrv, t_pccd1, t_pccd2
+ - Power up after switch-off
+
+
+Version 1.01.114
+================
+(Made by Graham, 29th July 1997)
+
+1) Matthew
+ 1) SW1-244 Fixed sound driver so that it no longer returns
+ KErrAlreadyExists if a prepare function is called
+ twice. Changed test code accordingly.
+
+2) Morgan
+ 1) SW3-1556 Removed dependency in M32HAL.H on M32DBG.H and
+ re-inserted dependency on M32DBG.H in appropriate .CPP
+ files.
+
+
+Version 1.01.113
+================
+(Made by Graham, 25th July 1997)
+
+1) Dennis
+ 1) Fixed CSW3-1559, CSW3-1560, CSW3-1530, SW1-91, SW1-155, SW1-158
+ Added doubly-linked tree structure to DLibrary objects to record which
+ DLLs depend on which. The access count of a DLibrary object is now equal to
+ the number of thread/process handles open on it, plus the number of other
+ DLibrary objects which have a dependency on it. Added code to DLibrary::Close()
+ to check that a DLL is really in use (directly or indirectly) by traversing
+ the tree structure and to delete it if it is not. Added a new supervisor function
+ UserSvr::DllAddDependency() used by the loader to record DLL dependencies.
+
+2) Matthew
+ 1) Fixed bug in sound ldd which caused buffers to be orphaned on the kernel heap if
+ a prepare function was called twice. This now returns KErrAlreadyExists.
+ Added test code to t_sound.
+
+3) Graham
+ 1) Made further changes to the backup battery levels:
+
+ Good -> Low 2850
+ Low -> Replace 2800
+
+ Replace -> Low 2850
+ Low -> Good 2900
+
+ Not present 2000
+
+ 2) SW1-201. Reduced the maximum voltage of the main battery
+ from 3100mV to 3000mV.
+
+ 3) SW1-179. Removed redundant IMPORT_C declarations from
+ E32BASE.H on:
+
+ CServer::NewSessionL
+ CSession::ServiceL
+
+ 4) Added Charles Wier's ASSERT macro.
+
+ 5) Changed the battery voltage reading algorithm. I used
+ to do one one dummy read on the adc channel then wait
+ 10mS then take the real reading. I now do 10 dummy
+ reads at the rate of one every millisecond and then
+ take the real reading.
+
+ 6) Fixed the .REL files to release Dutch and French
+ localisation dlls and a french keyboard table for MARM P2.
+
+ 7) Added Scandinavian localisation dll in WINS and MARM
+ builds.
+
+ 8) Added DANISH/NORWEGIAN keyboard table (CAKDP2.DN) and
+ SWEDISH/FINNISH keyboard table (CAKDP2.SF) for P2
+ MARM builds.
+
+Version 1.01.112
+================
+(Made by Graham, 17th July 1997)
+
+1) Dennis
+ 1) Fixed CSW-2710, SW1-114
+ Changed four kernel faults to K::PanicCurrentThread with new KERN-EXEC
+ panic numbers; these are KK::EMesAlreadyPending, KK::EEvntRequestPending
+ and two instances of PP::EIllegalWsProcess.
+
+ 2) Fixed CSW3-880
+ Corrected checking of filename length in RLoader::LoadProcess() and added
+ a check for the command line length.
+
+ 3) Fixed CSW3-1340
+ Changed the code to allow both heap min size and heap max size to be zero.
+ However if heap max size < 256, then a value of 256 will actually be used.
+
+ 4) Fixed CSW3-1601
+ Set up the value of K::TickCounter in the RTC tick ISR rather than in code
+ which runs asynchronously to the RTC tick. Reinitialise K::TickCounter when
+ the system time is changed.
+
+ 5) Fixed CSW3-1670
+ Added function TBool TTickQ::CheckMidnightCrossover(TInt aSecs) to check if
+ a midnight crossover has occurred and set iTomorrowStarts accordingly. Added
+ overloaded function void TSecondQ::SystemTimeChanged(TUint& aChanges)
+ to abort all absolute and locked timers and set the EChangesMidnightCrossover
+ bit in aChanges if a system time change results in a midnight crossover.
+ TSecondQ::SystemTimeChanged() now calls this function, as does
+ ExecHandler::LocaleSet(). Updated T_CHNOT.CPP to test the new RChangeNotifier
+ behaviour.
+
+ 6) Modified prefetch abort handler to set iDataAddress to the value of lr when
+ the exception occurred.
+
+ 7) Corrected User::StartThread to call DLL entrypoints with EDllThreadDetach
+ rather than EDllThreadAttach when the thread exits.
+
+ 8) Set the RTC correction to zero on a cold start. (Forgot this last time!)
+
+2) Graham
+ 1) Added code to fetch the language index and the keyboard
+ index from E2. Added these values to the machine info
+ structure (UserHal::MachineInfo()) by adding class
+ TMachineInfoV2 which derives from TMachineInfoV1.
+
+ 2) Modified the text window server to load a different
+ localisation module and keyboard module according to
+ the language and keyboard indexes read from E2.
+
+ 3) Increased the adjustment for current consumption
+ that is made prior to establishing whether the main
+ battery status should fall.
+
+ 4) Reduced the voltage levels at which the main battery
+ status changes. Low is now at 2150mV, Replace is now
+ at 1900mV (P2 and PD variants only).
+
+ 5) Reduced the max backup battery voltage to 3100mV in
+ line with the max main battery voltage (P2 and PD
+ variants only).
+
+ 6) Reduced the voltage levels at which the backup up
+ battery status changes:
+
+ Old (mV) New (mV)
+ Good -> Low 2900 2800
+ Low -> Replace 2800 2750
+
+ Replace -> Low 2850 2780
+ Low -> Good 3000 3000
+
+ Not present 2000 2000
+
+ 7) Added kernel side EXPORTS for:
+ S::ChunkCreate
+ S::LibraryLoadExact
+ S::MutexCreate
+ S::PhysicalDeviceLoad
+ S::PhysicalDeviceFree
+ S::SemaphoreCreate
+
+
+3) Basher
+ 1) Added new function in the keyboard translation dll
+ (ChangeKeyData) which loads a different keyboard data
+ module.
+
+4) Pete
+ 1) When interrogating the CIS of a PC Card to determine the cards type,
+ the PC Card controller verifies the integrity of the CIS by
+ attempting to follow each CIS chain to the end. While performing this
+ operation the controller is currently reading each tuple entirely
+ rather than just checking its type and link. This is un-necesary and
+ in fact not recomemded. Unknown tuples may contain active registers.
+ This change fixes the problem.
+
+
+Version 1.01.111
+================
+(Made by Graham, 11th July 1997)
+
+1) Jonathan
+ 1) Small fix to DPccdCntrlInterface::DoNotifyChange and DoChangeFlag to return
+ KErrGeneral instead of panicing on being passed an invalid socket number.
+ 2) Kernel now exports all of DPlatChunkHw so that device drivers can map
+ in their own memory-mapped registers etc.
+ 3) Added 2nd serial port (16550-based) to Snowball MARM variant. Currently
+ just a dummy because of a suspected bug triggered by ~DPlatChunkHW().
+ 4) Variant::TestBootSequence on Snowball is always True. This enables an
+ (alternative) etest.exe to be run on boot, which starts elink before booting
+ normally.
+ 5) Added etestl.exe which does the above.
+
+2) Pete
+ 1) Fixed SW3-1226
+ Makes it possible to force accesses to as particular type of PC Card
+ memory (ie Common,Attribute,I/O) to be 8-bit accesses only (ie 32bit
+ word accesses disabled). This mode can be enabled in the function
+ Variant::PcCardCntrlMemConfig() by returning KMemConfigByteAccess.
+ This is to support h/w implementations which can't support 32-bit accesses
+ to PC Card memory.
+
+3) Dennis
+ 1) Fixed SW3-1321
+ Moved the RTC correction value and last set time into the super page so
+ that they will be preserved over warm resets. This stops strange offsets
+ from being added to the system time when the machine is switched off and on.
+
+ 2) Moved the definition of the super page from M32STD.H to K32STD.H. Added a
+ super page to the WINS build. Moved the battery statistics (insertion time,
+ time on main battery, time on external power, battery power used) from K::
+ into the super page so that they will be preserved over warm resets.
+
+ 3) Fixed SW3-1419
+ Removed all user access from user data chunks in the home section. Changed
+ the way the stack/heap chunk is created on thread creation - the pages are
+ now allocated using DPlatChunk::AdjustL() instead of AdjustUserL(). This means
+ that the pages are immediately mapped with the correct page permissions
+ rather than with full user access. Removed the line in DPlatProcess::Loaded()
+ which applies the final page permissions to the main thread's stack/heap chunk.
+
+ 4) Fixed SW3-1317
+ Modified function RUserHeap::SvClose() so that if it finds the access count of
+ the heap negative, it panics the owning process rather than causing a kernel fault.
+
+ 5) Fixed SW3-1311
+ Fixed operator precedence error in CObjectIx::Remove().
+
+ 6) Fixed SW3-770, SW3-1539
+ Modified DPlatProcess::DoSetPriority() to recursively descend the tree of threads
+ owned by the process and adjust their priorities (previously, thread-relative threads
+ were not adjusted).
+ Introduced a new set of absolute thread priorities which enable the priority of a
+ thread to be made independent of the priority of its owning process.
+ Note that this upgrade requires a modification to the SHELL to set the priority of
+ the EIKON server thread to EPriorityAbsoluteForeground instead of EPriorityMore.
+
+ 7) Fixed SW3-319
+ Added a new exported function Kern::PanicCurrentThread(const TDesC&, int) which panics
+ a thread by sending a message to the kernel server (like K::PanicCurrentThread).
+ Modified D_COMM.CPP to call this function instead of DPlatThread::Panic().
+
+ 8) Fixed SW3-1604
+ Modified RThread::RaiseException() so that if the exception is unhandled, it panics
+ with ECausedException rather than calling User::Exit(KErrDied);
+
+ 9) Fixed SW3-4688
+ Modified UPWINS\UP_TRP.CPP to do a ret 4 at the end of User::Leave() instead
+ of a compiler-generated ret 0. Applied the same modification to the X86 build.
+
+ 10) Fixed SW3-1408, SW3-1671
+ Modified UCDT\UC_REGN.CPP TRegion::SubRect() to return without doing anything if
+ the rectangle to be subtracted is empty. Applied the same modification to the
+ ARM version in UPMARM\UP_UTL.CPP.
+
+ 11) Fixed SW-4688
+ Modified UPWINS\UP_TRP.CPP User::Leave() to end with a ret 4 instead of a ret 0.
+ Applied the same modification to the MX86 version.
+
+ 12) Fixed SW3-1149
+ Added an inline accessor function for the iThread member of CAsyncOneShot to
+ allow the handle to be changed.
+
+ 13) Fixed SW3-1604
+ Modified RThread::RaiseException() so that if the exception is unhandled, it
+ panics with ECausedException rather than calling User::Exit(KErrDied);
+
+ 14) Fixed SW-5529
+ Modified RLibrary::LoadRomLibrary in UPMARM\UP_LIB.CPP and UPMX86\UP_LIB.CPP
+ to close a handle in all possible cases.
+
+ 15) Fixed SW-5530
+ Modified KS_SEM.CPP, KS_MUTX.CPP and KS_CHK.CPP so that if a global object is
+ created with a thread-relative handle, it has no owner.
+
+ 16) Modified DPlatThread::Die() so that if a system thread panics, the machine resets.
+
+ 17) Fixed SW1-22
+ Modified CObjectIx destructor to invalidate each array entry after closing it.
+ Modified CObjectIx::Remove() to panic if an attempt is made to remove an entry with
+ a null object pointer.
+ Modified S::Close() to check if the handle is valid before attempting to close it.
+
+ 18) Fixed CSW3-1426
+ Made 0x10 (DLE, non-breaking space character in OPL) a whitespace character.
+
+ 19) Fixed CSW-5500
+ Check for nDig<0 in doGeneral() function, return KErrGeneral in this case.
+
+4) Matthew
+ 1) Fixed SW3-883
+ Moved the undertaker notification call Kern::NotifyThreadDeath() from
+ DThread::Cleanup() to DThread::DoDie(), so it is called before any child threads
+ are killed.
+ Added test to T_THREAD.
+
+ 2) Fixed SW3-1173
+ Made "%X" give upper-case, instead of lower-case hex.
+ Added test to T_BUF.
+
+ 3) Changed T_SOUND test code so that it actually tests that keyclicks are disabled
+ during recording.
+
+ 4) Renamed Variant::TVarmpdPanic to TVarmp2Panic in P2 variant.
+
+ 5) Made varmp2\va_prom.cpp #include v32armp2.h instead of v32armpd.h.
+
+5) Graham
+ 1) Anns fix for incompatibility between random number
+ generation on WINS and MARM.
+
+ 2) Martin Tasker's updated header files E32BASE.H and
+ E32DEF.H for MSVC 5.0 compliance.
+
+ 3) Increased RAM refresh rate to the maximum in the
+ bootstrap. This can then be slowed down in the
+ variant layer if applicable.
+
+ 4) Changed the reschedule code to run with interrupts on.
+
+ 5) Added Charles Wier's __DECLARE_TEST_DEBUG that compiles
+ out in release mode.
+
+ 6) Added Charles Wier's RTest::SetConsole(CConsoleBase*).
+
+ 7) SW3-716 sanitise E32KEYS.H for the resource compiler.
+
+ 8) SW3-1556 released M32MMU.H and .INL in INCK and removed
+ dependency in M32HAL.H on M32DBG.H.
+
+ 9) SW3-1557. Fixed an ASSERT in Mmu::AllocShadowPage().
+
+ 10) Added new Central European language enums to TLanguage.
+
+ 11) Changed RNotifier::Connect to use its own version number
+ instead of the operating system version number - the
+ notifier interface is updated independently of E32.
+
+ 12) Merged in new in localisation files since 110.
+
+ 13) Fixed bug in ARM architecture which caused ADC code
+ to be called when the variant specified that no
+ ADC was fitted - caused problems for Delaware.
+
+ 14) Changed the main battery monitoring code to compensate
+ for voltage drops with high current consumption when
+ calculating changes in battery status.
+
+ 15) Changed the main battery monitoring code to increase
+ the frequency that it samples the main battery voltage
+ when other components are interested in obtaining
+ accurate readings of that voltage.
+
+ 16) Changed the P2 and PD sound driver to divorce its ability
+ to play digital sound from the main battery status. It
+ now has two threshhold voltages - one at 2200mV below
+ which no sound driver operation will begin and another
+ at 2000mV below which any sound driver operation that
+ is in progress will be aborted.
+
+ 17) Fixed the backup battery code which caused its status to
+ oscillate between Good and Low every time you switched
+ off and on.
+
+ These fixes, in combination should fix CSW-5376, CSW3-682,
+ CSW3-1672
+
+6) Basher
+ 1) Added new user server function "ChangeLocale" to change
+ localisation dll.
+
+Version 1.00.110
+================
+(Made by Graham , 5th June 1997)
+
+1) Graham / Jonathan / Morgan / Colly
+ 1) Fixed a bug in the Comms LDD emergency power down code.
+ This was causing interrupts to be enabled which then
+ caused the kernel irq handling routine to reenable
+ fiqs thus causing the fiq handler to be reentered with
+ subsequent death of a random nature to any user code
+ that might happen to be lying around within reach.
+ Multiple SW's hopefully.
+
+ 2) Introduced interrupt protection around
+ TEiger::ModifyRegister8. This had been introduced into
+ TEiger::ModifyRegister32 a long time ago but somehow got
+ missed out of the 8 bit variant.
+
+ 3) Added protection against rogue irqlevels passed into
+ Hal::RestoreIrqs();
+
+ 4) Added NOPs into the following type of ARM assembler
+ construct:
+
+ asm("stmia lr, {r13-r14}^");
+ asm("add lr, lr, #8");
+
+ This now becomes:
+
+ asm("stmia lr, {r13-r14}^");
+ asm("mov r0, r0");
+ asm("add lr, lr, #8");
+
+ The ARM manual advises against using a banked register
+ directly after any user-bank load or store multiple
+ instruction.
+
+ 5) Added T_IRQS test code developed by Alastair.
+
+
+Version 0.01.109
+================
+(Made by Graham , 3rd June 1997)
+
+1) Dennis
+ 1) 2/6/97
+ Fixed SW-3795, SW-3798
+ Set main battery insertion time after initialising RTC
+ When system time is set, main battery insertion time is changed
+ by (new system time-old system time)
+ Moved initialisation of Locale data from S::Initialise() to P::Initialise()
+ just after Hal::Init1(). This is necessary to make sure that the home time
+ offset is initialised before the system time on a cold start.
+
+ 2) Fixed alloc heaven problem in KS_CHN.CPP whereby a
+ physical channel is created and not deleted if the
+ corresponding logical channel creation failed.
+
+2) Matthew
+ 1) Changed sound and comms emergency power-down code to do their completions
+ with DFCs. This seems to fix the exception-type resets associated with
+ emergency power-downs.
+
+ 2) Fixed a bug in the sound driver's write-to-thread code where the home
+ address of the user buffer was not being used. Spotted by Colly.
+
+ 3) Fixed bug in sound driver where if an Open() failed with OOM then any
+ subsequent attempts to open would fail with KErrInUse. Spotted by Colly.
+
+3) Pete
+ 1) Fixed SW3-998: Prevents emergency power downs occuring
+ while servicing PC Card interrupts from generating an exception.
+
+
+ 2) Fixed SW3-974: Machine reset inserting CF card with OOM.
+ Fix is low risk (FLW). One part affects code only called in OOM
+ situation, and the other is minor change to a destructor.
+
+4) Graham
+ 1) Fixed a bug in the comms logical device driver. This bug
+ prevented the machine from switching on sometimes in the
+ presence of an oscillating DSR input (like Nautilus).
+
+ 2) Fixed a bug in the backup battery handling when switching
+ on. This again was preventing machine from turning on
+ occasionally. Thanks to Colly, Bill and Morgan for help
+ finding this one. SW3-666 (the number of the beast).
+
+ 3) SW3-877. Slowed down the turning off of the display
+ when switching off normally - the previous behaviour
+ may have been damaging to the lcd panel. (UNAPPROVED)
+
+ 4) SW3-997 fixed a keyboard table bug when pressing FN+B
+ followed by the space bar - previously gave a little
+ circle; now gives a circumflex. (UNAPPROVED)
+
+ 5) Upped the LCD pump value to 11 from 8. SW3-354.
+ (UNAPPROVED)
+
+ 6) Changed MachineInfo for P2 to describe the microprocessor
+ as an ARM 7100 rather than an ARM 7110. SW3-1028.
+ (UNAPPROVED).
+
+5) Morgan
+ 1) Fixed RTC error. Conversion between parts per 4000000
+ and parts per 2^24 was wrong.
+
+Version 0.01.108
+================
+(Made by ---, --- May 1997)
+
+1) Matthew
+ 1) 22/5/97
+ Fixed SW-5406: Made the fall-back alarm sound slightly less offensive.
+ Forward and backward compatible.
+
+ 2) 22/5/97
+ Fixed SW-4899: WINS comms pdd no longer calls the ldd's transmit ISR the
+ extra time.
+ Backward compatible, not forward if you were assume the transmit ISR
+ can only be called once.
+
+ 3) 22/5/97
+ Fixed SW3-293: Moved EWSRV.DLL to base 0x42800000 so it no longer clashes
+ with dsound.ldd.
+ Forward and backward compatible.
+
+ 4) 22/5/97
+ Fixed SW3-372: Added the '%.' label to TTime::FormatL. This gives the
+ locale decimal separator. Test code in T_TIME.
+ Backward compatible, not forward compatible - previous versions of
+ E32 reduced '%.' to '.' whatever the locale information was.
+
+2) Morgan
+ 1) 23/5/97
+ Fixed SW-4604: When a growing Ram Drive hits a page containing
+ page tables the page allocator attempts to move them. This code was
+ assuming all four page tables in the page were in use which is not
+ always the case, causing the allocator to Leave. To fix this, trapped
+ the Leave when an unused page table is not found in the PageDir.
+ Forward and Backward compatible.
+
+ 2) 27/5/97
+ Applied the correct Uids and capitalised the names of EKern and EFile
+ by hand during startup. Required because neither of these processes
+ are loaded by the file server (which is normally responsible for doing
+ that).
+
+ 3) 27/5/97
+ Added RProcess::SetType(const TUidType &aType) and test code.
+ Backward compatible
+
+3) Ann
+ 1) 27/5/97
+ Changed KRealFormatNoExponent to use a maximum of aMaxSigFigs digits.
+ Updated test code accordingly.
+
+4) Graham
+ 1) 28/5/97
+ SW3-495. Reduced the risk of E32 getting out of step with case
+ opening/closing
+
+ 2) 28/5/97
+ Introduced BLDARMREL as a synonym for ARMREL in MNT.CMD and
+ removed the need to do MAKEWORK before building.
+
+
+Version 0.01.107
+================
+(Made by ---, --- May 1997)
+
+1) Graham
+ 1) Removed MEDCRR.MAP and DATXPD3.MAP from MARM releaseables
+
+ Forward and backward compatible.
+
+ 2) Removed EKERN.LIB from WINC releaseables
+
+ Forward and backward compatible.
+
+ 3) Upgrade 003
+
+ Fixed SW3-282. If the 'switch off when case is closed' option was
+ enabled and one switched off, closed the case, then attempted to wake
+ the machine up using the external buttons or by asserting dsr, then
+ the machine would remain dead until the next warm reset.
+
+ This was fixed by reading the state of the case when coming out of
+ standby as well as every second while switched on.
+
+ Forward and backward compatible.
+
+ 4) Upgrade 007
+
+ Removed the ability to turn on using the digitiser after an emergency
+ power down. This makes the behaviour consistent with 'Switch on when
+ case is opened'. SW-5282
+
+ Forward and backward compatible.
+
+ 5) Upgrade 008
+
+ Upgraded P2 and PD digitiser drivers to include debouncing logic
+ (SW-874 and duplicates).
+
+ Forward and backward compatible.
+
+ 6) Upgrade 009
+
+ Upgraded P2 and PD comms pdd's. These now implement the following
+ current consumption scheme.
+
+ RS232 drivers enabled 2mA
+ Cable connected + 22 mA
+ Ir enabled 0 mA
+ Ir receiving 0 mA
+ Ir transmitting + 35 mA
+
+ The cable is detected by either:
+
+ 1) DSR high
+ 2) Character received
+
+ Forward and backward compatible.
+
+2) Pete
+ 1) Upgrade 001
+
+ Fixed SW3-331. Formatting of Local Drives was being done cardSize/32
+ bytes at a time. This was OK on smaller CF cards but on larger ones
+ (eg 16M Hitachi CF) it was locking up the machine for long periods
+ (because F32 which is running during each sub-format is at a high
+ priority). Changed so that a Local Drive is formatted
+ Min(16K,size/32) bytes at a time.
+
+ Forward and backward compatible.
+
+ 2) Upgrade 004
+
+ In addition to having the option to disable compatibility checking between a cards
+ Vcc level requrements and those supported by a machine, it is now possible
+ to disable Vcc current and Vpp level compatibility checking in
+ TPcCardConfig::IsMachineCompatible().
+
+ Backward compatible, not forward.
+
+ 3) Upgrade 005
+
+ Fixed a problem parsing device info. tuples which fail to provide the
+ end of field character. TCisReader::FindReadRegion() now checks the
+ length of such a tuple and doesn't rely on the terminating character
+ being present.
+
+ Forward and backward compatible.
+
+ 4) Upgrade 006
+
+ Various changes to Pc Card Serial Port PDDs:
+ - Added Cellular Card Phone Serial Driver (VA_NCCP.CPP) for Rack D.
+ - Fixed a problem with the standard Modem Card Serial Driver (EUART3.PDD)
+ when writing to the card at 115Kbps. The driver wasn't making full
+ use of the Tx FIFO and was spending too long servicing interrupts
+ resulting in a triple beep reset due to the watchdog timing out.
+ Also disabled Vpp compatibility checking in order to support the
+ WorldPort modem.
+ The full list of supported modems is now:-
+ - Socket I/O serial port
+ - Dacom Goldcard V34 + Fax
+ - Dacom GoldCard Global (V34+Fax)
+ - Hayes Optima 288
+ - US Robotics WorldPort
+ - MegaHertz XJ2288
+ - Trellis Datacom PC288V2
+ - Com1 Modem Card MC218
+ - Paldio Data card
+ - Changes to Delaware standard Modem Card Serial Driver (EUART2.PDD)
+ to bring it up to same standard as the Rack D driver.
+ None of this affects Protea P2.
+
+ Forward and backward compatible.
+
+3) Ann
+ 1) Upgrade 002
+
+ Fixed SW-4304, SW3-415. TRealFormat changes. Changed
+ Calculator mode to discard trailing zeros first and then to decide on
+ exponential or non-exponential format based on the number of digits
+ available. If the number of digits (including significant leading/trailing
+ zeros) when using non-exponential format would exceed aMaxSigFigs, then
+ exponential format would be used, so reducing to no more than aMaxSigFigs.
+ Fixed SW3-416. The above changes should been this situation won't
+ occur, but leaves space for sign now, just in case!
+ Also T_FLOAT test code improved and updated.
+
+
+Version 0.01.106
+================
+(Made by Graham, 19th May 1997)
+
+1) Graham
+ 1) Implemented MNT VALID verb.
+
+ Forward and backward compatible.
+
+ 2) Updated all version numbers to 1.0(106)
+
+ The compatibilty issues for this are quite complicated.
+ However, I believe these changes to be both forward and
+ and backward compatible.
+
+ 3) Added .MAP files to MARM releasables.
+
+ Forward and backward compatible
+
+ 4) Changed idle current to 38mA, backlight current to 98mA.
+
+ Forward and backward compatible
+
+ 5) Upgrade 004
+
+ Changed the WINS fascia to reflect the changed order on the
+ application bar.
+
+ Forward and backward compatible
+
+ 6) Upgrade 009
+
+ Fix which defends against the possibility that the Flash ROM will not
+ wake up quickly enough when coming out of standby. We jump into RAM
+ to execute the standby instruction. When we come out of standby we
+ check the ROM is reading correctly before jumping back.
+
+ Forward and backward compatible
+
+ 7) Upgrade 010
+
+ SW-5179 Return an error if an attempt is made to turn the backlight
+ on when the main batteries are set to 'replace' and no external power
+ is being applied.
+
+ Forward and backward compatible
+
+ 8) Upgrade 011
+
+ Reduce default on time of backlight to one minute and make it
+ sensitive to user activity.
+
+ Forward and backward compatible
+
+ 9) Upgrade 012
+
+ SW-5319 Changed default screen contrast of PD and P2 variants
+
+ Forward and backward compatible
+
+ 10) Upgrade 013
+
+ SW-3264 Changed default auto power down behaviour to
+ 'Enabled always' and reduced the default timeout to
+ 3 minutes.
+
+ Forward and backward compatible
+
+ 11) Upgrade 014
+
+ SW-3232 Swop round FN-Q,D and FN-Q,T
+
+ Forward and backward compatible
+
+2) Dennis
+ 1) Changed wait states on CS1 ROM from 4 to 2 on P2 variant.
+
+ Forward and backward compatible
+
+ 2) Modified ImpHal::PrepareForRepro() to leave the cache and
+ write buffer enabled. It is only necessary that the page
+ directory entries for the FLASH are marked as not
+ cacheable or bufferable and that the TLB and cache are
+ flushed, which was already the case.
+
+ Forward and backward compatible
+
+ 3) Upgrade 001
+
+ Rewrote some of the TRegion member functions in ARM assembly language in an attempt to
+ speed up the operation of the window server, which uses these functions extensively, and
+ which was found to be responsible for slow operation of the machine when a large number
+ of applications are open. See defect reports SW-3500 and SW-4478 and the replies to them.
+
+ Forward and backward compatible
+
+3) Ann
+ 1) Upgrade 002
+
+ Fixed a bug in Math::Pow() (defect report SW-4624) so that
+ KErrOverflow errors are not incorrectly returned as KErrArgument
+ errors. This occured because of differencing of infinity - which is
+ now checked for. Updated maths test code (t_math) to test this
+ change fully.
+
+ Forward and backward compatible
+
+ 2) Upgrade 025
+
+ Fixed SW3-317 KRealFormatNoExponent mode was not checking for
+ KExtraSpaceForSign flag. Now checks and changed to act accordingly.
+ Also added this to test code.
+
+
+4) Morgan
+ 1) Upgrade 003
+
+ Set a constant string in the SuperPage when platform initialisation
+ has completed. This string is checked on warm resets to validate
+ cold start initialisation has completed successfully at some point
+ in the past.
+
+ Forward and Backward compatible except for machine configuration
+ compatiblity. So, machine configurations may not be passed
+ between old and new versions of E32. You must perform a cold
+ reset having upgraded to the version of E32 because of this
+ change.
+
+
+ 2) Upgrade 019
+
+ Fix for SW3-91 and SW3-66: Shared code chunks are Open()ed properly
+ in DProcess::Create(). New code chunks are named "$EXE[<Checksum>]"
+ and no longer have an owner.
+
+ 3) Upgrade 026
+
+ Initialised TheSuperPage.iXtalError to 0 in Hal::Init1() on a cold boot
+ for those platforms that don't do it themselves in their variant
+ initialisation.
+
+5) Matthew
+ 1) Upgrade 005
+
+ Changed "Rings" alarm sound to be the same as those on the 3a. Thanks to Jezar
+ for his help with this.
+
+ Also adjusted the trailing silence in algorithmic alarms as suggested.
+ Fixes SW3-22.
+
+ Forward and backward compatible
+
+ 2) Upgrade 006
+
+ Fixed SW3-256: Arm sound ldd no longer links to localisation dll.
+
+ Forward and backward compatible
+
+ 3) Upgrade 007
+
+ Fixed bug SW3-25: Requests on logical channels by threads which did not open
+ that channel will now panic the rogue thread, rather than potentially crashing
+ the whole machine.
+
+ Added test code to T_SOUND.
+
+ Forward and backward compatible
+
+ 4) Upgrade 008
+
+ Fixed bug SW3-9. Wins fixed (again) to take account of NT daylight saving settings.
+
+ Forward and backward compatible
+
+ 5) Upgrade 023
+
+ Fixed SW3_315. In the sound LDDs play and record dfc functions the value of
+ iThread.iExit is now tested, and if it is not EExitPending then the function
+ returns straight away.
+
+ Forward and backward compatible
+
+6) Pete
+ 1) Upgrade 015
+
+ SW3-138 Change to CF card interrupt enable scheme. Currently the MTD keeps
+ card IREQ interrupts enabled in Etna while its open. These are normally
+ disabled at the card level but enabled in the card during a write operations.
+ When the media switch is broken or when a dodgy CF card is present, this can
+ resulting in a watchdog timeout due to the card permanently asserting IREQ and
+ not responding to the interrupt clear. This change leaves IREQ disabled
+ in Etna until required for the write operation.
+
+ Forward and backward compatible
+
+ 2) Upgrade 016
+
+ Change only for variants with 2 sockets (ie RackD). Currently on these systems,
+ when a media change occurs, the PC Card controller does the following
+ to each socket in turn before turning off Vpc:
+ - Disable IREQ
+ - Disable Etna interface
+ However, because the two sockets have an individual IREQ, but share
+ the same Data/Address buffers, when the Etna interface is disabled on
+ the 1st socket, it causes the RESET signal to the 2nd to become
+ active. This in turn causes the 2nd socket to permanently assert IREQ
+ (which is now Rdy/Bsy) while its IREQ interrupt could potentially be
+ enabled. Result is continuous interrupts followed by watchdog
+ timeout.
+ The fix is to disable IREQs on both sockets before disabling the Etna
+ interface. This is done in the variant code for Rack D - ie no impact
+ on Protea P2.
+
+ Forward and backward compatible
+
+ 3) Upgrade 017
+
+ Change to test program DRVSOAK so that it monitors the amount of
+ spare RAM while soak test is running.
+
+ Forward and backward compatible
+
+ 4) Upgrade 027
+
+ Fixed SW3-440. Older SanDisk CF cards still sometimes timeout when
+ running on batteries. Increased timeout in CF card media driver from 60ms
+ to 70ms.
+
+ Forward and backward compatible
+
+ 5) Upgrade 028
+ Fixed SW3-434. Allow CIS parsing functions not to reject a CIS which
+ has incorrect link tuples.
+ If a CIS chain contains no link tuples then a check is made for a link target
+ tuple at address 0 in common memory (as before). However, if a link
+ target isn't found here then we assume a normal end of the CIS chain
+ (rather than marking the entire CIS chain as invalid as before).
+ If a CIS chain contains a 'Long Link to attribute memory' tuple but no link
+ target tuple is found at address: (specified offset x2) then we also check for a
+ link target tuple at address: (specified offset x1).
+
+ Forward and backward compatible
+
+7) William
+ 1) Upgrade 020
+
+ Changes to test programs so that they run from CF card on top of the full
+ Protea ROM. T_CTRAP, T_POWR, T_UID from TBAS, the rest from TCDT. Still more changes
+ required to fix "Z:\Test" assumptions and the strange bug with the EIKON console.
+ T_CTRAP will now fail on WINS debug because it checks the stack depth.
+
+ Forward and backward compatible
+
+ 2) Upgrade 021
+
+ Extend RChangeNotifier to do EChangesSystemTime: effects E32STD.H and KSRC\KS_TIM.CPP, KS_NOFTY.CPP
+ There is a Defect for this, but it's really an E32 Proposal trying to be noticed...
+
+ Backward compatible, not forward compatible if you take
+ advantage of this new feature.
+
+ 3) Upgrade 022
+
+ Check in DThread::Cleanup to see if the dying thread is the one which currently owns the event hook.
+ If so, cause a 'graceful' kernel fault instead of an
+ 'ungraceful' one further down the line (SW3-205).
+
+ Forward and backward compatible
+
+ 4) Upgrade 024
+
+ Fixed SW3-73. Puts the first 8 characters of the Panic/Fault category into the codeAddress
+ and dataAddress of the last exception information (except, of course, if we are faulting
+ because of an exception...)
+
+ Forward and backward compatible
+
+8) Geert
+ 1) Upgrade 029
+
+ Fully source and binary compatible. Not link compatible, however. See below for details.
+
+ Fixed SW3-11, replacing the following EUSER.DLL exported functions with binary equivalents:
+
+ CArrayFix<TAny>::CArrayFix(TBufRep aRep,TInt aRecordLength,TInt aGranularity);
+ CArrayFix<TAny>::~CArrayFix();
+ CArrayFixFlat<TAny>::CArrayFixFlat(TInt aRecordLength,TInt aGranularity);
+ CArrayFixFlat<TAny>::~CArrayFixFlat();
+ CArrayFixSeg<TAny>::CArrayFixSeg(TInt aRecordLength,TInt aGranularity);
+ CArrayFixSeg<TAny>::~CArrayFixSeg();
+ CArrayVar<TAny>::CArrayVar(TBufRep aRep,TInt aGranularity);
+ CArrayVar<TAny>::~CArrayVar();
+ CArrayPak<TAny>::CArrayPak(TBufRep aRep,TInt aGranularity);
+ CArrayPak<TAny>::~CArrayPak();
+
+ All CArrayXxx<TAny> stock instances acquire inline ctors just like the template ones.
+ If you use any of these classes then to be able to link against the new EUSER.LIB
+ will require re-compilation.
+
+ A clean build should be sufficient.
+
+ 2) Upgrade 030
+
+ Entirely backward compatible. Forward compatible for all software that doesn't use the new service.
+ And additional forward incompatible change now allows the element just past the array to be addressed
+ using CArrayXxx::End().
+
+ Fixed SW3-374, adding new exported function
+
+ TAny* CArrayFixBase::Back(TInt anIndex) const;
+
+ as well as inline wrappers to CArrayFix<T> and CArrayFix<TAny>.
+
+ These functions provide functionality equivalent to CBufBase::BackPtr(), being CArrayFixXxx::End()
+ counterparts for fast _backward_ iteration.
+
+ Also introduced modifiable overloads of End() inline wrappers and relaxed index range checks for
+ CArrayFixXxx::End() as well as Back().
+
+9) Jonathan
+ 1) Upgrade 031
+
+ Fixes SW3-334
+
+ Debug::SetBreakpoint only allowed breakpoints to be set at 0x2xxxxxxx (and at
+ 0x5xxxxxxx in debug releases). Eikon apps get loaded into memory between
+ 0x9000~ and 0xFFFF~.
+
+ Debug::SetBreakpoint allows breakpoints between 0x9000~ and 0xFFFF~.
+
+ No API change. Doesn't depend or tread on any previous upgrade.
+
+ Forward and backward compatible
+
+
+Version 0.01.105
+================
+(Made by Pete, 8th May 1997)
+
+1) Dennis
+ 1) Modified the scheduler to set machine current consumption to either
+ running or idle current depending on whether the null thread is
+ being scheduled.
+ 2) Added functions Custom::BacklightCurrentInMilliAmps() and
+ ImpHal::BacklightCurrentInMilliAmps and code to include the
+ backlight current in K::TotalCurrentMilliAmps when it is on.
+ 3) Fixed a problem with average battery current calculation - the function
+ was using a hard-coded tick rate of 10 ticks per second.
+ 4) Changed function DLogicalChannel::SetCurrentConsumptionInMilliAmps from
+ protected to public since in practice it is always the PDD which calls it.
+ 5) Modified the sound and COM1 PDDs to set the current consumption according
+ to the device state.
+
+2) Morgan
+ 1) Digitiser calibrated from values in E-squared Prom on a Cold Start.
+ 2) Calibration preserved over a warm reset.
+ 3) Plugged in crystal error and machine unique Id values from the E-squared.
+ 4) DPlatProcess destructor closes the process code chunk, and Create() adds
+ newly created code chunks to the list of Kernel chunks.
+ 5) RLoader::LoadProcess() Kill()s the new process on a failed load.
+
+
+3) William
+ 1) Reorganise CDeltaTimer creation to fix SW-4030
+ 2) Remove TDblQueLInkBase::EnQue() assertion, to fix SW-4991
+ 3) Reset auto switchoff timeout when an absolute timer completes, to fix SW-4870
+
+4) Ann
+ 1) Fixed bug SW-4351 in Math::Mod(). Now returns KErrTotalLossOfPrecision
+ if an accurate answer cannot be given.
+ 2) Reorganised maths test code so it now builds for ARM.
+
+
+5) Andrew 1) Fixed bug SW-4180. SetReserveL(TInt) is now available only
+ for CArrayFixFlat<T>, CArrayFixFlat<TAny> and CArrayPtrFlat<T>.
+ The parameter is new the reserved size of the array, not the
+ reserved expansion space.
+
+6) Pete 1) TPcCardSocket::SetSocketStatus() made virtual function.
+ 2) Added the inline function
+ TPcCardSocket::EventCallBacksRequested(TPccdEvent anEvent).
+ Used to determine if there are any clients expecting notification of
+ a particular PC Card event.
+ 3) CROM Media Driver Caps() no longer sets the drive attributes as
+ KDriveAttRom.
+ 4) Fixed problem parsing Configuration table entry tuples where the
+ last two entries both have the same configuration entry value. Prior to
+ this, only the first of the two was reported.
+ 5) ATA Media Driver now leaves card interrupts enabled in the PC Card
+ Controller h/w, and enables/disables these as required on the card. This
+ is quicker than the previous scheme where it was continuously enabling
+ and disabling interrupts in controller h/w on each Write() request.
+ 6) Media Driver Open() failures due to media change now only return
+ KErrNotReady rather than any other error value.
+ 7) ATA Media Driver now verifies that a partition is a DOS partition
+ (extended DOS partitions not supported).
+ 8) ATA Media Driver now uses Pulse mode interrupts where possible.
+ Previously it always used Level mode interrupts.
+ 9) Change to ATA Media Driver - for write requests
+ which straddle a sector boundary and require prior reading of two
+ consecutive sectors, the read is now performed with a single read
+ command (of two sectors) rather than two reads of one sector.
+ 10) Default attribute memory access speed for 3.3V
+ socket is 600ns rather than 300ns (as per PC Card Spec.).
+ 11) Withered Custom::DriveName() and Custom::PcCardSocketName() in
+ custom dll.
+ 12) Prevented DPrimaryMedia queueing same DFC twice.
+ 13) Introduce Media Driver Interface version number.
+ 14) Made media driver current consumption values more realistic.
+
+7) Jonathan
+
+ 1) The Debug class won't let the user insert breakpoints or
+ single-step into ROM code before the aDebugLimit argument to
+ Debug::Open. Gdbstub sets aDebugLimit to its own location in
+ ROM, thus preventing breakpoints/stepping into code before it in
+ ROM (including EUser, EKern etc) which might otherwise break.
+
+ 2) The Debug class ignores the user-supplied aDebugLimit in Release
+ builds and prevents setting of breakpoints/single-stepping
+ anywhere in the ROM.
+
+ 3) Binary incompatibility (affects gdbstub & test code, doesn't
+ affect RDebug::Printf):
+ Debugger functions in the RDebug & Debug classes changed to use
+ thread Ids instead of opaque DThread pointers. Components that
+ call RDebug::ReadMemory() or RDebug::WriteMemory() should pass in
+ RThread().Id() as the first argument to these functions to retain
+ their current functionality.
+
+ 4) New DThread* Kern::ThreadFromId(TThreadId) for use by Debug
+ class. Also changed S::ThreadOpen(... TThreadId, ...) to use it.
+
+8) Matthew
+ 1) Fixed SW-3783 - by default, the comms driver now uses descriptor
+ MaxLength() rather than Length() for reads.
+ Note: This fix has meant a change to the inline function RDevComm::Read(),
+ so anyone using this function should recompile with the new E32. You
+ know who you are.
+ 2) Fixed bug in comms driver so that it no longer crashes if you
+ request that it writes beyond the end of a descriptor.
+ 3) Stopped WINS sound pdd from gurgling when you do a PlaySineWave().
+ 4) Moved DTMF volume information from sound LDD into the PDDs, since
+ it depends on the frequency response of the hardware.
+ 5) Tiny amount of fiddling with algorithmic alarm sounds.
+ 6) Made the __WINS_UID() macro expand in WINC builds, implementing the E32
+ proposal.
+ 7) Removed the EChangesAll enum from E32STD.H since if it used it may break
+ forwards compatability. This should only effect BAFL.
+ 8) Added a User::SetCurrencySymbol() function for setting the system-wide
+ currency symbol.
+
+9) Graham
+ 1) Added German keyboard table which now gets
+ released as CAKDP2.GE
+ 2) Released IMPORT_C from TInt64A functions. These
+ were not being exported anyway.
+ 3) Exported RLibrary::LoadRomLibrary on EPOC
+ platforms
+ 4) Fixed update of battery statistics when the
+ main batteries are changed (SW-5096, SW-4228).
+ 5) Fixed update of main and backup battery statuses
+ when switching on (SW-3401, SW-4479).
+ 6) Changed UK, US, and German keyboard tables to give
+ the multiplication and division signs when the
+ appropriate keystrokes are made.
+ 7) Shortened the beeps for Cold Start, Warm Start,
+ and Kernel Fault.
+
+
+10) Jal
+ 1) Added build infrastructure for ELOCL.GE
+ (the german localisation dll).
+
+Version 0.01.104
+================
+(Made by William, 2nd May 1997)
+
+1) William
+
+ 1) Removed the TRAPD() from DThread::RequestComplete, which still seems
+ to cause lots of E32USER-CBase 71 and 63 panics when used in the
+ harsh environment of real test roms
+ 2) Remove reference to GateFunction in EGATE.DEF to fix the T_DUID.DLL test
+ 3) Add extra test cases to TCDT\T_THREAD.CPP
+ 4) Add missing XCUST*.DEF files to BMARM\LI.PRJ
+
+Version 0.01.103
+================
+(Made by Morgan, 1st May 1997)
+
+1) Graham
+
+ 1) Fixed a problem with the code which looks for both shift
+ keys when switching on after a warm reset in order to
+ change it into a cold reset.
+
+ 2) Fixed a problem with constructing the encrypted password
+ in the super page.
+
+Version 0.01.102
+================
+(Made by Morgan, 30th April 1997)
+
+1) Pete
+ 1) Change to PC Card Serial Driver (EUART3.PDD) for Rack D. Added
+ followers for 16550 registers IER,LCR,MCR rather than relying on
+ them being read/write registers. Tested this driver using
+ COMMS(033) app. Sent/received files at various baud rates up to
+ 57600 (didn't test at 115K) using XMODEM without any problems. The
+ above driver works with the following PC Card Serial Ports/Modems:
+ - Socket I/O serial port
+ - Dacom Goldcard V34 + Fax
+ - Hayes Optima 288
+ 2) Now possible for ATA media driver to return the following errors
+ on read or write command fails:
+ KErrCorrupt - Bad block detected / sector ID error.
+ KErrWrite - Write fault.
+ KErrTimedOut - Timeout waiting for ATA controller to negate
+ BSY bit.
+ KErrLocked - Timeout waiting for ATA controller to assert
+ RDY bit).
+ KErrGeneral - Protocol error (wrong state of DRQ bit
+ detected).
+ KErrUnknown - General ATA controller error.
+ KErrCancel - Command aborted
+ KErrDied - Uncorrectable error encountered.
+ Prior to this, all the above conditions resulted in KErrTimedOut.
+ (All of these get translated as before by F32 but the extra
+ information from the driver is useful).
+ 3) Format command now implemented using ATA WriteSectors command rather
+ than FormatTrack. This is because there seem to be a variety of
+ implementations of the FormatTrack command and also it can take a significant
+ time to complete (>200ms) on some cards which require CHS addressing.
+ 4) Changes to various trace o/ps to prevent system watchdog timeouts on media
+ changes with tracing on.
+
+2) William
+ 1) Use Win32 IsBadReadPtr/IsBadWritePtr functions to provide better emulation of
+ EPOC32 kernel exception handling (should allow us to handle the access violations
+ that the kernel has contingency plans for, even under the MSDEV debugger).
+ 2) Fix SW-1799 by preventing the Win32 thread priority from being raised too high
+ 3) Fix SW-???? by ignoring the KNotifyIfDie flag when WINS threads die (as per EPOC32).
+ 4) Trace the Win32 Thread ID and the WINS thread name in the debug window (WINS debug builds)
+ 5) Fix SW-4346 by making CalcChunkHeapCompression wary of corrupt heaps and wrapping the
+ invocation from ChunkCompressAll in a suitable exception trap.
+ 6) Arrange to keep iHandles valid (but empty) after thread cleanup
+ 7) Fix SW-3718 by making ChangeNotifier handles thread-relative.
+ 8) Prevent WINS RProcess::SetPriority from changing the Win32 process priority (SW-1799)
+ 9) Limit the size of a heap cell to 1 Gigabyte (SW-4528)
+ 10) Fix SW-4389 by ignoring UserSvr::InitRegisterCallback calls after initial bootstrap.
+ 11) Fix SW-3527 by ensuring that the SYSTEM.INI screenwidth is rounded up to a multiple of 16.
+ 12) Fix T_QUE, T_DLL1, T_DLL2 and T_SVR2 test failures.
+
+3) Graham
+ 1) Fixed WINS problem with expanded MachineInfo
+ structure.
+
+4) Bruce
+ 1) Two field dates are now accepted for all locales. Fixed year 2000 bug.
+ Removed hard-coded 'am'/'pm' and replaced these with data
+ retrieved from the localisation dll.
+
+5) Ann
+ 1) Fixed bug in TLex8::ScndigAfterPoint() (SW-4304) - now reads in first 18 significant
+ digits rather than just first 18 digits.
+ 2) Fixed bug in TLex8::Val() (SW-4355) - overflow in some cases was being returned as
+ positive regardless of actual sign.
+
+Version 0.01.101
+================
+(Made by Graham, 29rd April 1997)
+
+1) Graham
+ 1) SW-1921 Fixed the occasional load click by disabling interrupts while creating the click.
+ 2) Added localised keyboard tables to the P2 build
+ system and created CAKDP2.UK and CAKDP2.US. CAKDP2.DLL
+ remains and gives a layout consistent with the keyboards
+ currently on our Limes.
+ 3) Change the rombuilding system to accept a localisation
+ parameter. So you may use "rom rel p2 uk". If you specify
+ just "rom rel p2", you get what you always used to.
+ 4) SW-3330 Fixed repeating keys when entering 'Raw'
+ mode in the text window server while a key is depressed.
+ 5) SW-3837 introduced ELangInternationalFrench
+ 6) SW-4181 allocated WINS DLL address for MEDCRM.PDD
+ 7) Solved problem with watchdog timer going off sometimes
+ when coming out of standby.
+ 8) Changed Hal information names in preparation for the
+ final ROM.
+ 9) Changed supply voltage information so that it
+ never returns a voltage above the stated maximum
+ for that battery and returns zero millivolts if
+ the battery status is EZero. Changed the maximum
+ voltage for the main battery to 3100mV and for the
+ backup battery to 3200mV. SW-4194 SW-4237.
+ 10) Implemented the reading of ADC channel 7 on a cold
+ boot in order to detect when test department boot
+ to final test is required.
+ 11) SW-3563 Displaying years >2000 as 2 digits in
+ abbreviated form.
+ 12) SW-4339 Set CurrencyNegativeInBrackets to EFalse
+ in both the US and UK localisation dlls.
+ 13) Added structure for UserHal::CpuInfo(TDes8& aInfo)
+ 14) Added UserSvr::WsRegisterSwitchOnScreenHandling().
+ If a window server wants to take control of
+ turning on the screen, then it should call this
+ function with ETrue and may then call
+ UserSvr::WsSwitchOnScreen(). It may relinquish
+ control back to the Os by calling the register
+ function again with EFalse.
+ 15) Added the functions:
+ UserHal::SaveXYInputCalibration();
+ UserHal::RestoreXYInputCalibration(aType);
+ Restore takes an argument that may be EFactory (to
+ restore the factory set calibration) or ESaved to
+ restore the previously saved calibration.
+ 16) Added the following to the Machine Information
+ structure:
+ TInfoName iProcessorName
+ TInt iProcessorClockInKHz
+ TInt iSpeedFactor
+ TInt iMaximumDisplayColors
+
+2) William
+ 1) Added WINS SYSTEM.INI support for "MegabytesOfFreeMemory" which also turns on the
+ mechanism for limiting the total amount of memory which WINS can allocate.
+ 2) Number some more enumerated types associated with panics and faults. Note that this
+ includes removing #ifdef __XCON in KPWINS\KP_STD.H so that the KPWINS platform fault
+ numbers will change: prior permission was obtained from the BC police.
+ 3) In DEBUG builds, change RHeap::Free to fill the released block with 0xDE rather than 0
+ 4) Add __ASSERT_DEBUG to catch double insertion of a TDblQueLink (and fix two places in
+ the Base which weren't constructing a link when creating an object).
+ 5) Fix SW-3707 by not panicing unnecessarily in DPlatProcess::AllocateDataSectionBase()
+ 6) Fix SW-2104 in DTimer::Cancel(), by not calling RequestComplete on a dead thread, and
+ not doing the expensive timer scan in DThread::Cleanup().
+ 7) Fix SW-1185 by interpreting EKeyIncContrast to mean "bigger number in SetContrast" in the
+ text window server.
+
+3) Morgan
+ 1) Preserved the password and its enabled state over a warm reset.
+
+4) Matthew
+ 1) Added PlaySineWave() function to RDevSound. Also added an iMaxSineWaveFrequency
+ member variable to the sound caps structure. Frequencies are in Hz.
+ 2) Changed sound LDD so that it gets the alarm name via the kernel's
+ locale-message-text service. LS_SND.CPP and K32LSND.H have thus been scrapped.
+ 3) Fixed bug in sound LDD which caused a kernel panic if FlushRecordBuffer() was
+ called after a record request had failed with bad power.
+
+
+Version 0.01.100
+================
+(Made by Graham, 23rd April 1997)
+
+1) Dennis
+ 1) Modified ARM boot code to automatically work out the size and bus width of
+ the ROMs connected to CS0 and CS1 chip selects. This information is stored
+ in the super page in the iRomConfig entries. Both banks of ROM are then mapped
+ to consecutive linear addresses.
+ 2) Added a new function Hal::PrepareForRepro, which re-maps all the ROM in the
+ machine. This is to make sure repro works correctly even if ROM page shadowing
+ is in use. This function uses the information stored in the iRomConfig entries
+ in the super page to work out which ROM to map and how to map it.
+ 3) Removed ROM mapping calls from VA_HW.CPP for all variants, and added code to set
+ up the ROM speed and type. For P2 variant, added code to set up the ROM size
+ for CS1 and the total ROM size. This is required to ensure that repro will work
+ correctly even if the CS1 ROM is initially blank.
+ 4) Added code to SF_MAIN.CPP to load an LDD (BOOT.LDD) from Z: immediately prior to
+ loading the window server. This allows any shadowing of the ROM for bug fixes to
+ be done.
+ 5) Added a new function UserHal::RomInfo to read the iRomConfig entries from the
+ super page. Updated T_INF.CPP to display this information.
+ 6) Modified ARM boot code to allocate 1K for each page table instead of 4K as it
+ does at the moment. Also use page tables 6 onwards for ROM mapping instead of
+ 8 onwards, since page tables 6 and 7 are unused at the moment.
+ This saves 44K RAM for the standard Protea configuration.
+ 7) Modified ARM boot code to make checking the RAM configuration non-destructive.
+
+2) Graham
+ 1) SW-3765 Export TReal96::IsZero by number instead of by name.
+ 2) SW-3760 Removed E32VIRT.H from the release
+ 3) SW-3759 Removed temporary __ARRAY_NO_PTRS__ from E32DEF.H
+ and appropriate function definitions.
+ 4) SW-3058 Removed __DECLARE_DLL_UID().
+ 5) SW-3480 Removed default Southern daylight savings
+ time from the UK localisation DLL.
+ 6) SW-3565 Implemented ~ as FN+J on Lime keyboards
+ 7) SW-3564 Implemented the dial key as Fn+Menu on a
+ Lime and as F3 on WINS. This comes through as
+ EStdKeyDial and EKeyDIal (in E32KEYS.H).
+
+3) Morgan
+ 1) Moved the locale configuration into the SuperPage to preserve it
+ over a warm-reset.
+ 2) Implemented TDes::TrimAll();
+ 3) Checked Uid[1] in S::PhysicalDeviceLoad and S::LogicalDeviceLoad.
+ Added WINS Uids to the device drivers in the Base.
+ 4) Cold reset is now: Warm-reset followed by LeftShift+RightShift+On
+ to make it harder to do by accident.
+ 5) Fixed K::TickCounter synchronisation after standby, and initialised
+ iLastLock for locked timers.
+
+4) Matthew
+ 1) Fixed SW-2855 - the TRegion::Sort() and CArrayXxxBase::Sort() functions
+ have been changed from having no return value to returning TInts, they
+ will return KErrGeneral if there is a stack overflow.
+ 2) Fixed blitting bug in eiger text window server which caused blocks of
+ screen to be cleared.
+ 3) Fixed bug in sound driver which made it crash when given a zero-length
+ sample.
+
+5) Jal
+ 1) Added TLocaleMessageText to E32SVR.H
+
+6) Alastair
+ 1) Changed e32\wsrc\ws_main.cpp so that the eikon shell is not loaded
+ if the machine is in test department boot mode.
+ 2) Created new project e32\etest producing an executable which will be
+ loaded instead of ewsrv.exe if the machine is in test department
+ boot mode. This executable will attempt to load ewsrv.exe and
+ final.exe from the root directory of a cf card containing euser.dll,
+ edisp.dll and econs.dll from the base in directory D:\system\libs.
+ If this attempt fails, etest.exe will try to load elink.exe from
+ Z:\system\libs which will open the remote link so that the machine
+ can be booted down the serial port. If this fails etest.exe will
+ attempt to boot the machine up normally.
+
+7) Pete
+ 1) Fixed 'Emergency power down with CF card powered results in cold
+ reset' (SW-3620). This was due to QuickEmergencyStandby() not
+ disabling the Etna's wait state controller properly.
+ 2) Force ATA and CROM media drivers on ARM to only return KErrNotReady
+ rather than any other error value when a request is interrupted by a
+ media change.
+ 3) Added the function CardIsReady() to class DPcCardCntrl. This should
+ be used periodically while using the PC Card Controller to check that
+ a media change hasn't occured. The new function is a quicker alternative
+ to the function CardIsReadyAndVerified(). The later is now only used once
+ at the start of each interface with the controller.
+ 4) Requests to Write or Format the CROM card now return KErrAccessDenied
+ rather than KErrNotSupported.
+ 5) PC Card Controller now calls P::ResetAutoSwitchOffTimer() on each
+ call off RPccdWindow::SetupChunkHw() to stop the machine going into
+ standby in the middle of a long write to a CF card etc.
+
+Version 0.01.099
+================
+(Made by Graham, 18th April 1997)
+
+1) William
+ 1) Fix SW-3331 by ignoring Undertakers owned by threads which have themselves already died
+ 2) Tweak UPWINS\BLD.CMD to bootstrap ECONS.LIB more reliably
+ 3) Arrange for absolute timers to complete with KErrOverflow for times too far in the future
+ instead of treating them as times in the past (starts to fix SW-3566)
+
+2) Graham 1) Fixed leaving without a trap harness. This was
+ calling a slow executive function to panic the
+ thread inside a fast executive trap function.
+ Moved the call to panic to the user side.
+ 2) Added V32ARMP2.H to INCK release.
+ 3) Fixed a problem with 098 which meant that
+ EKERN.DLL was linking to ELOCL.US rather
+ than ELOCL.DLL (In WINS).
+ 4) Included device driver def files in the INCK
+ release.
+
+3) Matthew
+ 1) Fixed Sound device driver's DTMF tone generating
+ interrupt handler.
+
+4) Ann
+ 1) Fixed doCalculator() function so that KRealFormatCalculator mode displays in no exponent
+ mode only if full precision may be seen in this mode or if no mor precision will be available
+ in exponent mode.
+ 2) Fixed doNoExponent() function so that KRealFormatNoExponent mode reduces the number of
+ significant figures used if the given no won't fit. Now only raises an error if value is too
+ big or too small to fit into the given width.
+
+
+Version 0.01.098
+================
+(Made by Graham, 16 April 1997)
+
+Note: This release is neither 100% binary compatible with 097, nor 100% source compatible.
+ The binary incompatibility is to do with UID allocation changes, the source incompatibility
+ with the correction of "overriden".
+ The UID changes are such that narrow release DLLs should work as they are. Other targets need
+ tweaking, which maktran 063 will do for you. See below for details.
+
+1) GrahamA
+
+IMPLEMENTATION OF UNICODE CHARACTER CLASSIFICATION, CONVERSION AND COLLATION
+
+NEW FILES
+e32\inc\collate.h
+ header for Unicode collation system
+
+e32\inc\unicode.h
+ header for Unicode character classification system
+
+e32\unicode\collate.cpp
+ Unicode collation system
+
+e32\unicode\unicode.cpp
+ Unicode character classification and attribute retrieval
+
+e32\unicode\unitable.cpp
+ tables of Unicode character attributes; this file is generated by the READTYPE utility from unidata2.txt.
+
+CHANGED FILES
+e32\bmarm\elocl.mak:
+e32\bmisa\elocl.mak:
+e32\bmx86\elocl.mak:
+e32\bwins\elocl.mak:
+ added ls_unic.cpp to list of source files
+
+e32\bmarm\eloclu.def:
+e32\bmarm\eloclud.def
+e32\bmisa\eloclu.def:
+e32\bmisa\eloclud.def
+e32\bmx86\eloclu.def
+e32\bwins\eloclu.def
+ removed UpperTable, LowerTable, FoldTable, CollTable, TypeTable; added CharSet.
+ (where relevant) added ls_unic.cpp to list of source files
+
+e32\bmarm\euser.def:
+e32\bmarm\euser.frz:
+e32\bmarm\euserd.def:
+e32\bmarm\euserd.frz:
+e32\bmisa\euser.def:
+e32\bmisa\euser.frz:
+e32\bmisa\euserd.def:
+e32\bmisa\euserd.frz:
+e32\bmx86\euser.def:
+e32\bmx86\euser.frz:
+e32\bwins\euser.def:
+e32\bwins\euser.frz:
+ added TChar::GetUpperCase, TChar::GetLowerCase
+
+e32\bmarm\euser.mak:
+e32\bmisa\euser.mak:
+e32\bmx86\euser.mak:
+e32\bwins\euser.mak:
+ added collate.cpp, unicode.cpp and unitable.cpp to list of source files, and collate.h and unicode.h
+ to dependencies where needed
+
+e32\bmarm\euseru.def:
+e32\bmarm\euseru.frz:
+e32\bmarm\euserud.def:
+e32\bmarm\euserud.frz:
+e32\bmisa\euseru.def:
+e32\bmisa\euseru.frz:
+e32\bmisa\euserud.def:
+e32\bmisa\euserud.frz:
+e32\bmx86\euseru.def:
+e32\bmx86\euseru.frz:
+e32\bwins\euseru.def:
+e32\bwins\euseru.frz:
+ added TChar::Compose, TChar::Decompose, User::Fold (new overload), TUnicode::Fold,
+ TChar::GetBDCategory, TChar::GetCJKWidth, TChar::GetCategory, TUnicode::GetCategory,
+ TChar::GetCombiningClass, TChar::GetInfo, TCHar::GetLowerCase, TUnicode::GetLowerCase,
+ TChar::GetNumericValue, TChar::GetTitleCase, TChar::GetUpperCase, TUnicode::GetUpperCase,
+ TChar::IsAssigned, TChar::IsMirrored, TChar::IsTitle, User::TitleCase,
+ TChar::TranslateFromUnicode,TChar::TranslateFromUnicode.
+ changed entry for RLogicalChannel::DoCreate to suit new signature
+
+e32\dsound\d_sound.cpp
+ changed an erroneous use of TChar::Fold to TChar::UpperCase
+
+e32\inc\d32ftim.inl
+ corrected penultimate arg to RLogicalChannel::DoCreate to suit new type (const TDesC8 *, not const TDesC 8).
+
+e32\inc\e32std.h
+ added Unicode functions and constants to TChar class
+ added Unicode functions to User class
+
+e32\inc\e32std.inl
+ added inline definitions of TChar::Fold and TChar::TitleCase
+
+e32\inc\k32std.h
+ added declarations for ExecHandler::GetLocaleCharSet, Locl::CharSet, K::CharSet
+
+e32\inc\u32std.h
+ added definition of LCharSet and removed character type bits (__U, __L, etc.), from Unicode build
+ defined EExecGetLocaleCharSet and DExecGetLocaleCharSet
+ added declaration for Exec::GetLocaleCharSet
+
+e32\kearm\ke_int.cpp
+e32\keisa\ke_int.cpp
+e32\kex86\ke_int.cpp
+e32\kpwins\kp_utl.cpp
+ added ExecHandler::GetLocaleCharSet to the dispatch table
+
+e32\ksrc\ks_dat.cpp
+ in the Unicode build, removed K::TypeTable, K::UpperTable, K::LowerTable, K::FoldTable and K::CollTable
+ and added K::CharSet
+
+e32\ksrc\ks_exec.cpp
+ added Unicode functionality to existing functions; added ExecHandler::GetLocaleCharSet
+
+e32\ksrc\ks_ini.cpp
+ in the Unicode build, removed initialisation of K::TypeTable, K::UpperTable, K::LowerTable,
+ K::FoldTable and K::CollTable and added initialisation of K::CharSet
+
+e32\lsrc\ls_lat1.cpp
+ in the Unicode build, used preprocessor directives to remove unused material
+
+e32\lsrc\ls_table.cpp
+ added preprocessor directives to select Unicode-build or Ascii-build material as appropriate
+
+e32\lsrc\ls_std.h
+ in the Unicode build, removed the LAlphabet class and added the TheCharSet object
+
+e32\tbas\t_key.cpp
+e32\t_cdt\t_buf.cpp
+ collation tests now work with new Unicode stuff
+
+e32\t_cdt\t_char.cpp
+ now works with new Unicode stuff; and in the Unicode build tests character classification and
+ my new collation system
+
+e32\tlocale\t_chset.cpp
+ now works with new Unicode stuff
+
+e32\ucdt\uc_des.cpp
+ changed two erroneous uses of TCharF to TCharUC
+
+e32\ucdt\uc_des16.cpp
+e32\ucdt\uc_des8.cpp
+ Capitalize and CopyCP convert first letter to title case, not upper case, in the Unicode build
+
+e32\ucdt\uc_exec.cpp
+ character classification and conversion functions (TChar::IsUpper, etc.) now work for all
+ Unicode values in the Unicode build; added new Unicode-only functions like TChar::IsMirrored
+ and TChar::GetNumericValue
+
+e32\ucdt\uc_func.cpp
+ the Unicode versions of Mem::CompareC now use the Unicode locale-specific string-based collation
+ system implemented by the TCollate class in the new source file collate.cpp
+
+e32\ucdt\uc_ksvr.cpp
+ changed type of penultimate arg to RLogicalChannel::DoCreate from const TDesC* to const TDesC8*
+ so that it works in the Unicode build: this caused changes to exported function signatures in the
+ .def and .frz files
+
+e32\ucdt\uc_lex16.cpp
+e32\ucdt\uc_lex8.cpp
+ changed two erroneous uses of TChar::Fold to TChar::UpperCase: folding isn't guaranteed to make
+ characters upper case, and doesn't in the Unicode build, but UpperCase is
+
+e32\upmarm\up_exec.cpp
+e32\upmx86\up_exec.cpp
+e32\upwins\up_exec.cpp
+ added Exec::GetLocaleCharSet
+
+e32\upmarm\up_lib.cpp
+e32\upmx86\up_lib.cpp
+ changed an erroneous use of CompareC to CompareF
+
+2) William
+ 1) Used Win32 InterlockedIncrement/InterlockedDecrement to implement WINS LockedInc and LockedDec
+ 2) Implemented first-cut exception->leave translation for WINS (as per MARM)
+ 3) Added exception trapping to DThread::RequestComplete, to fix SW-2274
+ 4) Arranged not to complete requests if the requesting thread has already died
+ 5) Enhance T_HEAP test to include truly concurrent access to shared heaps
+ 6) Fix incorrect semaphore count on default heaps (as shown by the revised T_HEAP!)
+ 7) Correct implementation of DThread::GetRamSizes for shared heaps, to fix SW-2671
+ 8) Fix WINS implementation of RDebug::Print, which was assuming a zero-terminated string
+ 9) Add T_REASON, a utility which loops printing the restart reason using RDebug::Print.
+ This isn't a test program as such, but can be put on a CF card as \System\libs\wserv.exe
+ to help debug endless restarting.
+ 10) Improve DSession destructor to dequeue any messages which are marked EDelivered, in the
+ hope of fixing SW-1407 and friends.
+ 11) Implement scheme to orphan kernel CObjects when their owner goes away, to fix SW-1665 (again!)
+
+3) Dennis
+ 1) Modified prefetch abort, data abort and undefined instruction exception
+ handlers in ke_int.cpp to save correct context if exception occurs in
+ supervisor mode.
+
+4) Matthew
+ 1) Fixed SW-2408 (problems with signals when you come out af standby).
+ 2) Fixed SW-3293 (cancelling fallback alarm causes panic).
+ 3) Fixed bug with emergency power down during fallback sound.
+ 4) Increased DTMF buffer so if can now cope with 32 characters.
+ 5) Made kernel noises (keyclicks, buzzes and sound driver activity) obey
+ the state of the sound info. KErrAccessDenied is returned when sound
+ cannot be played. Fixes SW-2725.
+ 6) Yet more fiddling with algorithmic alarm sounds - fixed nasty distortion
+ occuring with chimes.
+ 7) Fixed potential memory leaks in CSecurityBase and CConsoleBase.
+ 8) Fixed TTime::RoundUpToNextMinute() and TTime::operator+(TTimeIntervalMonth)
+ so they now handle negative values correctly.
+ 9) Fixed SW-1974 (Switching on IrDA gives 0xff in Rx buffer).
+ 10) Changed comms PDD so that RS232 hardware is not enabled when IrDA is in use.
+ 11) Changed "KeyClickOverriden" to "KeyClickOverridden" in lots of places.
+ 12) Fixed SW-3097 (Wins Hal switch statement missing a break after TickPeriod).
+
+5) Graham
+ 1) Fixed (with help from Morgan) booting up into a text
+ shell on a normal eikon-based machine by placing
+ the appropriate components (EWSRV.EXE EUSER.DLL ECONS.DLL
+ EDISP.DLL ESHELL.EXE) in the \system\libs directory on
+ a CF card.
+ 2) Fixed SW-3163 (Alarms when the case is closed and
+ 'switch off when case is closed' is enabled).
+ 3) Fixed SW-3091 (Auto switch of in the presence of
+ 'switch on when case opens').
+ 4) Fixed SW-2893 (UserHal::MaxDisplayContrast(TInt&) in
+ WINS).
+
+6) Geert
+ 1) Removed the encoding of build variants in uid[0] of E32 images. Introduced
+ differentiation between EXEs and DLLs in uid[0]. EXEs have a uid[0] of
+ KExecutableImageUid [0x1000007a], DLLs come with one of KDynamicLibraryUid
+ [0x10000079]; ie, DLLs don't change for narrow release builds, EXEs get the
+ value previously used for narrow debug builds. EXEs won't load unless they
+ have their uid[0] changed.
+
+ 2) Changed lots of other private and public UIDs, taking care to preserve
+ compatibility for ARM builds. Unless you release an EXE you're alright, and
+ even EXEs can be fixed at rom build time.
+ UIDs of interest can be found in a bare <e32uid.h>, which, in addition to
+ KExecutableImageUid and KDynamicLibraryUid contains KLogicalDeviceDriverUid
+ and KPhysicalDeviceDriverUid--uid[1] values for device drivers--and unrelated
+ KMachineConfigurationUid.
+
+ 3) Removed the second PREP stage from the rom build process.
+
+7) Morgan
+ 1) Fixed a chunk problem with RAM loading the same process twice.
+
+8) Pete
+ 1) Fixed 'Panic in DPlatMediaChange::TickService()' in WINS
+ (SW-1962). Now ignore further media change events (F5 keydown)
+ while the door state is open (as per ARM).
+ 2) Fixed problems parsing the CIS of Multifunction PC Cards.
+ 3) Temporarily fixed 'Occasional Write() / Format()
+ timeouts when accessing CF card' (SW-3311) by increasing the
+ WaitForNotBusy() watch dog in the CF media driver from 40mS to 60mS.
+ 4) Door close event in WINS (F5 keyup) now processed
+ when the machine is in standby.
+ 5) CRom(Prog) media driver (MEDCRR.PDD) now
+ calculated the CRom size by attempting to read the intelligent ID
+ from each flash device. This driver now has 'high' priority to allow
+ it to open in preference to the normal CRom media driver.
+
+
+Version 0.01.097
+================
+(Made by ???, ??? April 1997)
+
+1) MarkT
+ 1) Added Early write completion to serial driver - D_COMM.CPP.
+ To enable set the flag KConfigWriteBufferedComplete in the
+ iHandshake of TCommConfigV01 and writes will be completed when
+ they are in the transmit buffer as oppose to waiting until they are
+ in the hardware. To flush data from the transmit buffer either
+ use Write(0), (Write(0) will not complete until transmit buffer
+ is empty), or unset KConfigWriteBufferedComplete and do a
+ write as normal.
+
+2) Pete 1) Change to CF media driver (MEDATA.PDD) so that this reverts to CHS
+ addressing if the LBA disk size is found to be invalid. Allows us to
+ work with Epson PC ATA card.
+ 2) Fixed a problem such that the second socket on rack D (E:) wasn't
+ properly being reset following a media change (DPcCardSocket::Reset1()
+ wasn't being called) - only applies to racks modified for
+ VPC control via the CHRGEN signal.
+ 3) Pc Card Controller now fully supports Memory Space Description fields
+ when parsing Configuration Table Entry tuples.
+ 4) Pc Card Controllers attribute memory chunk increased from 8K to 64K.
+ 5) Added the Delaware variant (VARMPG).
+ 6) Added PC Card Serial Driver (EUART3.PDD) for Rack D - ie providing a third
+ serial port on Rack D when PC Card Modem or Serial card is inserted into the PC
+ Card Socket (68pin socket). To use it you have to switch the '3.3V/5V' switch to
+ the 5V position (LEFT) and apply a 5V/500mA supply to the '+5V'pin next to this
+ switch. Unfortunately, without a modification to Rack D it is not possible to
+ turn this socket on/off under s/w control. The driver assumes the card is
+ permanently powered and if the rack goes into standby (or the media change switch
+ is operated) then the card is no longer useable.
+ This driver has only received limited testing:-
+ - With a Serial PC Card it passes T_SERIAL up to 115K baud as long as the power-off
+ tests are disabled and the serial port FIFO is enabled. (Passes T_SERIAL up to
+ 19200baud with FIFO disabled).
+ - Dacom V34 PC Card modem responds to an AT<CR> with T_TERM.
+ 7) Change to CROM media driver so that the page latch
+ is reset after each access. This ensures that the page containing the
+ cards CIS is always selected at the start of each access.
+ 8) Fixed problem where DPccdCntrlInterface::DoNotifyChange was adding the same TPccdCallBack
+ to two event queues. This resulted in the wrong event callback being
+ called on media change. This eventually lead to the situation where
+ the DMediaChange Dfc wasn't queued and the door close event was
+ missed. Any subsequent access to the CF card returned KErrNotReady.
+ (Fixes SW-2557)
+
+3) William
+ 1) Fixed HeapOffset/ChunkCompressAll interactions to ensure heap safety: the HeapOffset
+ is now set by RHeap::ChunkHeapCreated after the RHeap has been fully created, and
+ ChunkCompressAll now respects the RHeap critical sections.
+ 2) Add "DebugMask nnn" facility to WINS SYSTEM.INI (sadly you have to specify the
+ bitmask as a decimal number, but it's still useful).
+ 3) Start adding explicit numbering to some of the panic enumerated types, in particular
+ TBasePanic, TCdtPanic and TExcType.
+ 4) Implement CConsoleTextWin::SetTitle
+ 5) Add T_HCOMP.CPP heap compressing program used to cause ChunkCompressAll problems.
+ 6) Add __KTRACE_ANY which is similar to the previous version of __KTRACE_OPT
+
+4) Graham
+ 1) Made pointer click volume default to soft (on a cold boot)
+ 2) Removed Steve Townsend's change to TRegn::Clear()
+ 3) Removed the leading 'V' from version names
+ 4) Changed the fold and collate tables of the ISO
+ LATIN1 character set so that 'a with a ring above
+ it' and 'ae combined into one character' both
+ fold to an 'a' and so that 'o with a slash through
+ it' folds to an 'o'.
+ 5) Froze the complete kernel interface on all builds
+ except WINC.
+ 6) Published CConsoleBase interface def files in
+ CONSWINS.FRZ, CONSMARM.FRZ, and CONSMISA.FRZ.
+ These are released in the INCC zip file so they
+ will end up in \EPOC32\INCLUDE
+
+5) Morgan
+ 1) Released E32 as PETRANned components, complete with Uids.
+ 2) Removed RLibrary::UidL() and RLibrary::Gate() from the API
+ 3) Introduced TUidType RLibrary::Type() and
+ TUidType RProcess::Type().
+ 4) TLoaderInfo has changed, so this E32 and the new F32 must be
+ used as a pair.
+
+6) Matthew
+ 1) Fixed comms drivers so they return the correct Ir Capabilities
+ (KCapsSIR115kbps on Eiger).
+ 2) Fixed bug in WINS sound pdd which meant that sometimes cancelling
+ a play request would only finish after the sound had finished playing
+ anyway.
+ 3) Fixed bug in sound LDD which meant that samples up to the length of
+ the buffer could be played or recorded on one go. Now descriptors
+ must be less than or equal to the half the size of the buffer.
+ 4) Added code to check that the power was not too low for playing or
+ recording before it started. Also added code which checks the power
+ level while it is in use and aborts if the power drops too low.
+ 5) Further changes to the algorithmic alarm sounds - they now use beats,
+ as on the 3a.
+ 6) Added EChangesPowerStatus to the change notifier. This change occurs
+ when either of the two battery statuses changes, or if external power
+ is connected or disconnected.
+ 7) Fixed bugs in TTime::DayNoInWeek() and TTime::DateTime() which were
+ giving the wrong values for negative TTimes.
+ 8) Added horizontal tabs, delete and ascii bell to test window server.
+ Also made it ignore the null character and vertical tabs.
+
+Version 0.01.096
+================
+(Made by Graham, 2nd April 1997)
+
+Binary compatible with 095
+
+1) Graham
+ 1) Improved backup battery voltage monitoring
+ 2) Fixed a bug in the sound driver in the presence of
+ emergency power loss. This should cure all reported
+ problems of not being able to turn the machine back
+ on after playing sounds with low batteries.
+
+2) Dennis
+ 1) Fixed bug in unsigned division routine when used with
+ a divisor >= 0x80000000.
+
+3) William
+ 1) Implement primitive support for WINS memory gauge (SW-1183)
+ Note that this won't limit the total memory allocated, so the gauge can
+ exceed 100% (see Defects database for details).
+ 2) Report allocated base address even for chunks of committed size 0 (SW-1876)
+ 3) Fix dangling pointer problem with DChunk::AdjustL (SW-1793)
+ 4) Implement Steve Townsend's suggested shortcut in User::Free and User::FreeZ
+ 5) Tidy up handling of config structures in DoControl in D_COMM.CPP (SW-1970)
+
+4) Matthew
+ 1) Fixed SW-1994: Playing no sound can lock up machine.
+
+5) Pete
+ 1) Measurement of Vpc when powering up Pc Cards has now been enabled. This is in order
+ to reject cards which are found to be drawing excessive current.
+ (This had been disabled until it was possible to convert the ADC reading to millivolts).
+
+Version 0.01.095
+================
+(Made by Graham, 26th March 1997)
+
+1) William
+ 1) Fixed bug with shared heaps (SW-1665) and added failure scenario to the T_RHEAP test.
+ 2) Fixed SW-1884 bug about timer.At() alarms going off early after switchoff, and
+ enhanced T_POWR test to check for this.
+
+2) Morgan
+ 1) Added code to calibrate the digitiser based on the values in the
+ E-squared on a cold start. This may mean that if your E-squared
+ contains wildly outrageous values the digitiser will be out of
+ kilter. You can run \E32\TBAS\T_PROM to rectify this.
+
+3) Matthew
+ 1) Fixed B5/B6 bug SW-1726 (volume suddenly shooting to maximum).
+
+ 2) Moved algorithmic alarm data into the localisation dll, so the names can
+ be changed.
+
+ 3) Fixed B5/B6 bug SW-1630 in Comms PDDs: trying to set Mark and Space now
+ returns an error, and they are not returned as part of the capabilities.
+
+ 4) Changes to Etna comms:
+ Fixed bug where the TEtna class was ignoring the Parity-Enable bit.
+ Removed the Uart interrupt enable from the boot up, since it was being
+ switched off anyway, and made the Etna comms driver switch interrupts on.
+
+ 5) Added Comms driver power handling code. The behaviour is now that read and
+ write requests are completed with KErrAbort on normal switch-off and with
+ KErrBadPower if there is an emergency power down. On a power down the input
+ signals drop. On switch off, writes will keep going until the end of the
+ hardware fifo.
+
+ 6) Fixed some bugs in the Comms LDD to do with signals.
+
+ 7) Added Grahams K32DBGDD.H header file, which contains a helpful class for
+ debugging device drivers.
+
+4) Jal
+ 1) Changes to the Pccd interface controller to allow
+ access to media change notification. Added to UserPcCardCntrl:
+
+ IMPORT_C static TInt NotifyChange(TSocket aSocket,TRequestStatus *aReqStat);
+
+5) Graham
+ 1) Tightened up the backlight handling code and added various
+ backlight tests to T_POWR.CPP
+
+ 2) Made Steve Townsends modification to TRegion.
+
+ 3) Fixed a bug in Unicode in UM_RTOD.CPP
+
+6) Jonathan
+ 1) t_dbg: Added memory read/write tests to user data and, on
+ MARM, to Eiger registers.
+ 2) Forced RDebug::WriteMemory() to use Mem::Move for aligned
+ writes so that writing to Eiger registers works.
+
+7) Dennis
+ 1) Added code to implement real-time clock correction based on a
+ measured crystal error value in parts per 2^24, written into
+ K::XtalError at startup.
+8) Pete
+ 1) On media change, before writing to a thread which
+ has requested notification of media change, a check has been added to
+ verify the thread has not been destroyed.
+ 2) Fixed a problem with CRom media driver (MEDCRM.PDD).
+ Reads/writes from a position which wasn't on a word boundary (or of a
+ length in bytes which wasn't a multiple of 4), weren't previously supported.
+ 3) Implemented a 40ms watchdog timeout on writes to CF cards (MEDATA.PDD).
+ 4) Pc Card Controller now supports extended device
+ speed bytes when parsing Device Information Tuples.
+ 5) Added extra fixed media enum to TMediaDevice in E32PCCD.H.
+ 6) Various changes to Pc Card Controller to reduce code size.
+ 7) It is now possible to disable the media change
+ implementation by setting iTotalMediaChanges=0 in Custom::PcCardMachineInfo().
+ 8) Pc Card inactivity power down and 'not locked' power down periods can now be
+ set at the custom layer in Custom::PcCardMachineInfo().
+
+Version 0.01.094
+================
+(Made by Graham, 20th March 1997)
+
+1) William
+ 1) Changed __KTRACE_OPT for exact matches on multiple trace bits, and tweaked some
+ of the debug messages a bit.
+ 2) Enabled __KTRACE_OPT for WINS builds, writing to "Output" window under MSDEV
+ 3) Automatically set KPANIC trace bit if debug mask is non-zero
+ 4) Use aThread==NULL to mean &Plat::CurrentThread() in ObjectFromHandle functions,
+ and adjusted the callers appropriately
+ 5) Check in SvSendReceive to make sure that the iSvSession is not NULL, and
+ fault if it is: the most likely reason for this is a User::Panic in the Supervisor
+ thread, so we check to see if the message code is ESvThreadPanic and extract the
+ Panic category and code as appropriate.
+ 6) Added a new TCDT\T_KILLER.CPP test program.
+ 7) Added simple calibration of WINS ticks, to fix SW-1384 by making the clocks run on time...
+ 8) Arranged for Plat::Panic to add 0x10000 to the afult number and call Plat::Fault, so that
+ the machine will restart rather than loop forever.
+ 9) Put back tweaked VA_RCHG.CPP battery charging driver: it will charge batteries without
+ melting the machine, but it won't do so automatically: still needs more work.
+
+2) Graham
+ 1) Changed rack B,C,and D keyboard tables to interpret FN+cursor
+ keys as home, end, page down and up.
+
+ 2) Updated all keyboard tables to handle ctrl+fn as outlined in
+ the 090 release notes - not sure what happened to these changes,
+ they seemed to disappear some time after 090
+
+ 3) Added code to handle low battery situations a lot faster.
+ Typically, we remove power from all devices within 110uS and go
+ into standby within 130uS.
+
+ 4) Enhanced the P2 keyboard driver. It no longer locks the keyboard
+ out fully when three keys are pressed simultaneously. Rather, it
+ waits until fewer then three keys remain pressed before beginning
+ to deliver keyboard events again.
+
+ 5) Fixed a bug in the keyboard when switching on with the dictaphone
+ keys - it delivered the key down event but never delivered a
+ key up event when the key was released.
+
+3) Ann
+ 1) Changed TRealFormat KRealFormatExponent mode to be able to use
+ either significant figures or decimal places. Default is still
+ decimal places, but oring in the KUseSigFigs flag to the format type
+ will allow use of significant figures instead.
+
+ 2) Changed TRealForamtFixed mode so that negative numbers < -1 are
+ are "0" rather than "-0" when 0 dp are used.
+
+4) Dennis
+ 1) Exec::ThreadRead8, ThreadRead16, ThreadWrite8, ThreadWrite16, ThreadGetDesLength,
+ ThreadGetDesMaxLength now return an error code of KErrArgument if the pointer into the
+ remote thread address space is invalid, rather than panicing the caller. This fixes
+ problem SW-1013.
+
+ 2) Supervisor server functions invoked with a bad pointer will now panic the caller,
+ rather than causing a system fault and rebooting the machine.
+
+ 3) The sound driver LDD has been changed to allow only one channel to be open at a time.
+ This fixes problem SW-1165.
+
+ 4) All key and pointer clicks are now disabled during sound recording. This fixes
+ problem SW-817.
+
+5) Morgan
+ 1) Read the E-Squared ROM into RAM on a cold boot.
+
+
+Version 0.01.093
+================
+(Made by Graham, 14th March 1997)
+
+1) Pete
+ 1) Fixed a problem with inter-thread reading from CF card.
+ 2) Fixed a timeout problem with some CF cards when
+ formatting.
+
+2) Jonathan
+ 1) StrongARM port (ISA) brought up-to-date but not tested.
+
+ *) Base team please note that (rightly or wrongly) the ARM Custom
+ API is shared with ISA (file inc\v32arm.h), so any changes or
+ additions to the ARM Custom API must be reflected in the ISA
+ Custom implementation.
+
+3) Graham
+ 1) Fixed handling of the emergency power down queue. This
+ problem was due to the bad design of single queues - it
+ is impossible to fully check that you are enqueued without
+ traversing the queue from the top. We might look into
+ adding a more useful single queue type.
+
+Version 0.01.092
+================
+(Made by Graham, 13th March 1997)
+
+
+1) Pete
+ 1) Fixed problem with Format() in Compact Rom (repro version)
+ media driver (MEDCRR.PDD) such that it was only formatting the first
+ 2M of a CRom card.
+ 2) Compact Rom media driver (MEDCRM.PDD) now included in release.
+
+2) Graham
+ 1) Fixed an bug in the mmu abstraction which assumed that the page
+ directory was aligned linearly in the same way as it was aligned
+ physically.
+
+3) William
+ 1) Fixed a problem with threads dying
+
+Version 0.01.091
+================
+(Made by Graham, 12th March 1997)
+
+1) SimonB
+ 1) Fix for Serial PDD in NT 4
+ 2) Removal of dependancy on MSVCRT40*.DLL
+
+2) Morgan
+ 1) Added screen information to TRomHeader for the bootstrap
+ 2) Fixed corrupted ExcInfo on MARM by adding a FiqStack and
+ moving the exceptions onto the ExceptionStack.
+ 3) Moved TExcInfo to E32HAL.H
+ 4) System Death due to an exception now saves ExcInfo in the
+ Superpage and causes a Kernel Fault. Startup, Fault and
+ Exception reasons are available through:
+ UserHal::StartupReason()
+ UserHal::FaultReason()
+ UserHal::ExceptionId()
+ UserHal::ExceptionInfo()
+ There should be a Shell dialogue which retrieves
+ this information after a kernel fault. This will
+ enable us to pin down the offending code. Also, along
+ with each new Protea image, MAKSYM should be run and
+ the generated log file should be placed on the network
+ as well. This will give the address of every function
+ in every module of the ROM.
+ 5) Changed the startup beeps
+ ColdStart 1 beep
+ WarmStart 2 beeps
+ KernelFault 3 decending beeps
+ 6) Fixed SW-1069 - WINC heaps can grow up to 8Mb
+
+3) Graham
+ 1) Enabled the shift key when typing e.g. CTRL-1 a to give
+ a-umlaut.
+
+ 2) Solved the œ sign problem on WINS - this had been
+ re-introduced by Simon's WINS internationalisation
+ code.
+
+ 3) Re-introduced some digitiser inertia code to prevent
+ wobble.
+
+ 4) Re-structured the Spi controller code.
+
+ 5) Fixed a bug in CObjectCon::CheckUniqueFullName() that was
+ preventing two processes of the same name being loaded.
+ This cures problems with T_KHEAP.EXE and T_PROC1.EXE.
+
+ 6) Fixed T_KEYS.EXE by updating it for the new ISO LATIN 1
+ keyboard tables.
+
+ 7) Made TInt64::GetTInt() and TInt64::GetTReal() const.
+
+ 8) Swapped the dictaphone keys round (again?)
+
+ 9) Changed the emergency power down list to be on a single
+ queue instead of an object container.
+
+ 10) Changed the P2 keyboard table to make FN-e give e acute
+ and FN-SHIFT-e to give E acute. This is just to test that
+ such things are possible although it might be cool to just
+ leave this in since e acute is probably the most-used
+ accented character in English.
+
+ 11) Moved the accenting keys from CTRL+1-6 to FN+Q and FN+Z-B
+
+ 12) Completed anti-ghosting logic to disallow more than one
+ modifier and more than one normal key at the same time.
+
+ 13) Changed the text window server so that a pointer click outside
+ the region of any window will cause the foreground window to
+ change.
+
+ 14) Implemented battery voltage monitoring
+
+ 15) Increased the number of frozen functions in the kernel to
+ avoid BITGDI recompilations when E32 is released. Lane, you
+ will have to recompile, hopefully for the last time, for
+ this version of E32.
+
+ 16) Changed keyboard driver to recognise when the machine is
+ turned on. It will then scan the keyboard and deliver a
+ keyboard event only if the dictaphone keys are down. It then
+ waits for all keys to be up before proceeding to deliver
+ further events.
+
+4) Matthew
+ 1) Fixed B5 bug SW-266 ("%+0*S" formatted incorrectly).
+
+ 2) Put in Ir power-down fix (from Mark Ball).
+
+ 3) Added emergency power down handling to sound driver. The driver
+ completes statuses with KErrBadPower on emergency power down.
+ This fixes B5 bug SW-384.
+
+ 4) Added two functions to sound driver - BytesPlayed() and
+ ResetBytesPlayed() wich give the user feedback on how playing is
+ progressing.
+
+ 5) Increased the volume of EVolumeMedium in Eiger sound PDD so the
+ steps are more even. "Fixes" SW-543 (No apparent difference
+ between volume settings).
+
+ 6) Moved sound test code from F32 to E32.
+
+5) Jonathan
+ 1) Added SA ARM variant for Snowball.
+
+ 2) Fixed #defines in ROM.OBY file to make PREP happy.
+
+ 3) Made screen size a variant-dependent thing on ARM:
+ - Screen size is no longer hard-coded in ARM text window server
+ (wd_eiger.cpp) or ImpHal::Init3(). Text window server no
+ longer handles switching bit depth.
+ - LCD initialisation moved out of boot code into
+ ImpHal::Init3(), with size-dependant LCD initialisation in
+ Variant::Init3().
+ - ARM boot code uses screensize parameters in ROM header to
+ determine video RAM size and placement of page tables.
+
+6) Dennis
+ 1) Fixed a bug in the high-resolution timer code, and added a
+ Cancel() function to TMilliSecondCallBack.
+
+ 2) Added a logical device driver for the high-resolution
+ timer (EFTIM.LDD) accessed via RFastTimer class in
+ D32FTIM.H
+
+ 3) Fixed some bugs in 486 build of E32 and speeded it up
+ by enabling the processor cache and by coding the Mem::
+ functions in assembler.
+
+7) Ann
+ 1) Fixed a bug in TLex8::Val() which setting next to start of
+ string if an overflow occurred, causing problems for EIKON.
+
+8) Pete
+ 1) On ARM architecture, moved code for Etna device out of the Kernel
+ into the Variant DLL for P1,P2,RackC and RackD builds.
+ 2) Added iInterruptInfo to TPccdConfigInfo class. Users of
+ UserPcCardCntrl::GetConfig() must rebuild - only Pc Card test code should
+ be using this.
+ 3) Changes to the inter-thread Read()/Write() functions and the Format()
+ function of DMediaDriver to take a reference to a length (TInt &aLen rather
+ than TInt aLen). Read/Write/Format requests which would result in excessive time spent in the Kernel now only partly complete. They then return TErrTooBig
+ with aLength adjusted to the remaining length.
+ 4) Removed the current thread read/write functions
+ Read(TInt aPos,TintaLength,TDes8 &aTrg) and Write(TInt aPos,TDesC8 &aSrc) from class DMediaDriver as the inter thread read/write versions now perform the same function if the target thread is found to be current.
+ 5) ARM Ata media driver now adjusts auto power down timeout of CF card to 1sec. This prevents it from going into sleep mode between access which could affect CF card transfer rates (default is 5mS).
+
+Version 0.01.090
+================
+(Made by Graham, 26th February 1997)
+
+1) Graham
+ 1) Changed CTRL+FN+key behaviour. This is a complicated
+ issue. If one hits CTRL+FN+'1' on a Lime, then it is clear
+ that the Control and Function modifiers should be set.
+ However, what should the keycode be? It should be '1'
+ and not '_'. Higher level software is more interested in
+ the fact that CTRL+FN+'1' has been pressed than CTRL+'_' has
+ been pressed. For this reason, in 089, the keyboard tables
+ were changed to make CTRL override FN as far as keycode code
+ production was concerned.
+
+ However, consider the keystroke CTRL+FN+LeftArrow. In this
+ case, the opposite is true. Higher level software is more
+ interested in the fact that CTRL+HOME has been pressed
+ than that CTRL+FN+LeftArrow has been pressed.
+
+ So, in this release I have changed the keyboard tables to
+ cater for both problems by judging each key on an
+ individual basis. On a Lime, the keycode produced for:
+
+ CTRL+FN+'1' - CTRL+FN+'9' -> '1' - '9'
+ CTRL+FN+'A' - CTRL+FN+'Z' -> 0x01 - 0x1a
+ CTRL+FN+LeftArrow -> Home
+ CTRL+FN+RightArrow -> End
+ CTRL+FN+UpArrow -> PgUp
+ CTRL+FN+DownArrow -> PgDn
+ CTRL+FN+Tab -> CapsLock
+ CTRL+FN+Esc -> Off
+ CTRL+FN+' -> '
+ CTRL+FN+. -> .
+ CTRL+FN+<space> -> Backlight
+ CTRL+FN+, -> Help
+
+ 2) Changed the raw key code on WINS for the Alt key from
+ EStdKeyLeftAlt to EStdKeyLeftFunc. Attempted to get the
+ windows key to be the Epoc32 Alt key.
+
+ 3) Various additions to do with REPROing the upper 2Mb on
+ Limes.
+
+ 4) Protected the eiger internal registers from user mode access
+
+ 5) Introduced anti-ghosting algorithm into the P2 keyboard
+ driver. It doesn't, however, get rid of the ghost FN key
+ when you hold down LeftShift, DownArrow, and RightArrow
+ together. This leads me to believe that not all the diodes
+ have been fitted on the modifier keys.
+
+ The algorithm is basically one of 2-key rollover. So, any
+ keypresses made when two keys are already held down should
+ be ignored. Naturally, this is no good when you want to
+ hold down certain complex modifier and key combinations.
+ So, these special cases are compensated for in the software
+ in the knowledge diodes should be fitted into the modifier keys
+ to prevent any matrix-ghosting.
+
+2) Ann
+ 1) Fixed bug spotted by Natascha in doCalculator() so that values
+ with negative exponents are displayed correctly.
+
+
+Version 0.01.089
+================
+(Made by Jane, 21st February 1997)
+
+1) SimonB
+ 1) Removed dependency on WINMM. Timer now based on a RealTime thread
+ and sleeps.
+ Required for Win95 and general compatibility.
+
+ 2) Changed WINS Comms PDD to work with Windows 95
+
+ 3) Mark T's Comms PDD bug fixes integrated.
+
+ 4) International Keyboard support. Just UK and US at the
+ moment, more to follow.
+
+ 5) Removed first chance exceptions from WINS loading.
+ IsBadWritePtr replaced by VirtualQuery.
+
+2) Jane
+
+ 1) Finished the CObjectCon improvements suggested by Andrew. Note
+ that to pick these up you need the new version of
+ CheckUniqueName which takes CObject*s rather than names.
+ The time taken to Add 0x600 named objects to a container has
+ gone down from 14 seconds to 6 seconds.
+
+ 2) Added code for _ftol() to WINS and X86 builds. The function
+ header is in e32std.h
+
+ 3) Fixed various debugging printfs by supplying a simple overflow
+ handler so that long strings are truncated rather than
+ panicing the caller.
+
+3) Graham
+
+ 1) Fixed the œ gives ae keyboard problem by converting all
+ keyboard tables from CP850 to ISO Latin 1.
+
+ 2) Introduced a new key code - EKeyHelp. This is now F2
+ on WINS.
+
+ 3) Changed the WINS keyboard tables so that the dictaphone
+ keys give the correct raw scan code as well as the
+ appropriate Epoc32 key code. Did the same trick for
+ the menu, help and off keys.
+
+ 4) Fixed up the P2 keyboard tables. Note that the backlight
+ keys have to be handled in higher level software -
+ presumably the window server. On Protea the key code used
+ is EKeyBacklightToggle. However, a really skillful
+ implementation would handle EKeyBacklightOn and
+ EKeyBacklightOff as well (in case future hardware has
+ both on and off keys for the backlight).
+
+ 5) Fixed the P2 sticky shift and function modifiers.
+
+ 6) Removed the keyclick on shift, function and control keys.
+ This has only been implemented on P2.
+
+4) Pete
+ 1) Renamed EPccdEvent enums to prevent name clashing with
+ W32STD.H.
+ 2) Enabled media change interrupts on P2 hardware.
+
+5) Morgan
+ 1) WarmReset+LeftShift boots with EStartupColdReset on P1,P2,PB,PC,PD
+ 2) Added startup beep
+ 3) Fixed SW-32
+ 4) Write protected the Mmu page directory backup
+
+6) Ann
+ I IMPLEMENTATION OF SPECIAL VALUES:
+
+ TReal96, Math and TDes8/16 classes now handle "special values" - NaNs,
+ infinities, signed zeros and denormals.
+
+ Changes are as follows:
+
+ 1) Maths constants renamed:
+ K...ExponentBigBad now K...SpecialExponent
+ K...ExponentSmallBad now K...ZeroExponent.
+
+ 2) The Math member functions
+ ASin(), ACos(), ATAn(), Exp(), Frac(), Int(), Ln(), Log(), Mod(),
+ Pow(), Pow10(), Sin(), Cos(), Tan(), Sqrt()
+ have been changed as follows:
+
+ a) to return an error corresponding to the result, i.e.
+ KErrArgument if the result is indefined / a NaN,
+ KErrOverflow if the result is too big to be represented or infinite
+ positive only if the result is an integer),
+ KErrUnderflow if the result is too small to be represented (or if the
+ result is an integer, if the result is too large or infinite
+ and negative),
+ KErrNone if the result is finite and representable.
+ b) to write a result to the aTrg IN ALL CASES rather than just
+ the return value is KErrNone. Hence the result is as follows:
+ NaN if the error is KErrArgument,
+ Positive or negative infinity as appropriate if the error is
+ KErrOverflow (or the max value if the result is an integer),
+ Positive or negative zero as appropriate if the error is
+ KErrUnderflow (or the min value if the result is an integer).
+ c) to be able to handle denormals. i.e. all numbers >= 5E-324 and <
+ KMinTReal64=2.2250738585072015E-308.
+
+ 3) Math member functions IsZero(), IsNaN(), IsInfinite() and
+ IsFinite() added. Also private member functions SetZero(), SetNaN()
+ and SetInfinite().
+
+ 4) TDes8/16::Num/AppendNum() returns error value or length of string
+ as previously, but if error value is returned an appropriate string
+ is set:
+ "Inf" for positive overflow (KErrOverflow and positive argument)
+ "-Inf" for negative overflow (KErrOverflow and negative argument)
+ "0" for positive underflow (KErrUnderflow and positive argument)
+ "-0" for negative underflow (KErrUnderflow and negative argument)
+ "NaN" for NaN (KErrArgument)
+
+ 5) TDes8/16::AppendFormatList() only panics for KErrGeneral and
+ if another error value is returned by Num(), uses the string set
+ as above.
+
+ 6) The exponent of TReal96 zero is now -32768, the smallest exponent
+ possible.
+
+ 7) TReal96 member functions IsZero(), IsNaN(), IsInfinite(),
+ IsFinite(), SetZero(), SetNaN() and SetInfinite() added.
+
+ II ROUNDING FLAG:
+
+ See Programming DB - Global Rounding Flag Required
+ A new private member of TReal96, iFlag, has been added to
+ indicate whether the mantissa is rounded up, rounded down or exact.
+ This has required changes in member functions to set and use the
+ flag where necessary.
+
+ Changes are:
+
+ 1) iSign member changed from TInt16 to TInt8.
+
+ 2) Constants for values of iFlag added to e32math.h:
+ const TUint8 KRoundedUp=2;
+ const TUint8 KRoundedDown=1;
+ const TUint8 KExact=0;
+
+ 3) New TReal96 member function TReal96::Flag() which returns the
+ value of iFlag as a TInt.
+
+ 4) New private function TReal96::Round() taking an argument which
+ specifies the number of binary digits in the mantissa to perform
+ rounding in the (MSDEV and IEEE standard default) round to nearest
+ mode and to set the flag as appropraite has been added to be used by
+ Normalise(), Prepare() and conversion functions. New private member
+ function TReal96::ShiftToNormalise() added to be used in cases where
+ rounding will never be required e.g. assignment/construction of
+ TReal96 from TInt.
+
+ 5) TInt64::Multop() returns integer values between -2 and 1 with the
+ following meanings:
+ -2 least significant 64 bits exactly zero
+ -1 least significant 64 bits less than TInt64(0x80000000,0) but
+ not zero
+ 0 least significant 64 bits exactly TInt64(0x80000000,0)
+ 1 least significant 64 bits greater than TInt64(0x80000000,0)
+ and TReal96::MultEq() changed to round according to these values.
+
+ 6) TReal96::DivEq() rounds on the remainder after division similarly.
+
+
+ All maths test code updated to test special cases including
+ correct return values and setting target values and new functions,
+ etc. Also fixed to work in X86 build.
+
+
+ III OTHER
+
+ 1) UP_GCC.CPP function converting double to float changed to raise
+ the exception. Also all arithmetic changed to do operation and
+ conversion and raise the exception if an error value is returned at
+ any stage.
+
+ 2) Function TReal96::CheckOverUnderflow() used by arithmetic now a
+ private member function and altered to check fewer large-exponent
+ cases for overflow.
+
+7) Matthew
+ 1) Fixed SW-25 from B5 database (Power off while recording hangs machine).
+
+
+Version 0.01.088
+================
+(Made by Jane, 12th February 1997)
+
+This version requires F32 053
+
+1) Graham
+ 1) Sorted out the digitiser. This should no longer
+ exhibit wobble or erroneous points when touching
+ the surface lightly.
+
+ 2) Updated digitser driver to use the new digitiser
+ clicks rather than the keyboard clicks. These
+ should now be indepenently controllable.
+
+2) Jane
+ 1) Added an implementation of User::IsRomAddress from
+ Simon B.
+
+ 2) Added CArrayFixBase::SetReserveL
+
+ 3) Fixed a chunk bug - when a TFindChunk was opened read-only
+ in a process, the top bit of the process address (data
+ section) was set to indicate this. If another thread was
+ then created in the process, its heap address was incorrectly
+ allocated over the TFindChunk, as the latter's address was
+ stored with top bit set.
+
+ 4) Fixed a shared chunk bug on 486 - when T_CHUNK opened the
+ Window Server chunk RO, and then did an Exec::SessionSend
+ to the WindowServer, there was a fault when the kernel
+ attempted to write the message into the Window Server's
+ heap. Fixed this by unsetting the WP bit in CR0, so that
+ supervisor can write over User RO chunks. This is OK on the
+ ARM, but a thing to look out for if we ever port to another
+ processor.
+
+ 5) Improved CArrayPtr<T>::ResetAndDestroy as suggested.
+
+ 6) Changed profiler end/start behaviour as detailed on Notes.
+
+ 7) Started to optimise CObjectCon::CheckUniqueName as suggested
+ by Andrew Thoelke.
+ The time taken to store 0x200 unnamed objects has gone down
+ from 6 seconds to being as close to 0 as makes no difference.
+ More on this later...
+
+ 8) Added __ftol to EUSER.
+
+ 9) Added CObjectCon::AtL which leaves rather than panicking, so that
+ the kernel can panic a thread which passes an invalid find handle to
+ open, rather than dying itself.
+
+ 10) Increased the WINS main user thread's max heap size to 8M.
+
+3) Pete
+ 1) Moved sections of code relating external interrupt control and binding out of
+ the Kernel DLL and down into the Variant DLL.
+ 2) Code for Pc Card external interrupts (Ready,IREQ,Status change) added.
+ 3) CF card media driver now makes use of card IREQ signal during card writes. This
+ now goes into idle after initiating a write to the card, with the card asserting
+ an interrupt on completion to wake up the system.
+ 4) Added a media driver for compact rom card (MEDCRM.PDD).
+ 5) Written media driver for programming flash on compact rom card(MEDCRR.PDD).
+ 6) Modified the functions
+ 7) Changes to functions CardInfo() and ChangeFlag() of UserPcCardCntrl class.
+ 8) Monitor the Vpc voltage on first applying power to a Pc Card to check that
+ the card isn't drawing too much current for the rail.
+ 9) Alteration to media change simulation in WINS:
+ F5 - Media door open as long as F5 is held down.
+ F4 - This toggles between 1 of two simulated CF cards on socket 0 (ie X:)
+ when hit while F5 is held down.
+ 10) All files used to simulate Pc Card memory and internal ram drive now created in
+ systems temp directory rather than \EPOC32\DATA - ie fixed HA-262.
+ 11) Fixed problem with ATA media driver - divide by zero.
+ 12) Removed support for Rev 1.0 Asic12.
+ 13) Check battery status before commencing write to CF Card - return with
+ KErrBadPower if battery is low.
+ 14) CF Card driver now handles emergency power down.
+ 15) Pc Card power consumption - K::PcCardCurrentMilliAmps
+ now implemented.
+
+4) Matthew
+ 1) User::SetHomeTime() has been changed to return a TInt. This will return KErrOverFlow on
+ Arm if the new time is out of range (past about 2068, before about 1932).
+
+ 2) Sound driver: Added more click controlling code and implemented a fallback alarm.
+
+
+Version 0.01.087
+================
+(Made by Graham, 5th February 1997)
+
+This release is binary compatible with 086
+
+1) Graham
+ 1) Implemented dictaphone keys in WINS:
+ F6 Dictaphone Play
+ F7 Dictaphone Stop
+ F8 Dictaphone Record
+
+ 2) Begun the production of power supply
+ information from UserHal::SupplyInfo().
+ Expanded test code in t_power accordingly.
+
+ 3) Added the P2 variant which will be used for green
+ machines. Changed the keyboard variant to include
+ the dictaphone keys.
+
+ 4) Added PD and P2 variants to the releaseables.
+
+ 5) Added the function UserSvr::TestBootSequence(). This
+ returns true if the machine is being booted by the test
+ department. The file server should call this function and
+ load etest.exe rather than ewsrv.exe if this is the case.
+
+ 6) Added the function UserHal::ResetAutoSwitchOffTimer().
+
+
+ 7) Added the function UserSvr::AddEvent(). This enables user
+ code to add events into the event queue. Quite apart from
+ the numerous applications that this might spawn, it is
+ necessary for user side implementation of a VT100
+ console driver and handwriting recognition software.
+
+ 8) Added the EKeyMenu, EKeyBacklightOn,
+ EKeyBacklightOff, and EKeyBacklightToggle keycodes
+ to all variants. On WINS the F1 key is used as the
+ MENU key.
+
+ 9) Rationalised the MARM rom building system. This is
+ now controlled by a single ROM.OBY file which is
+ preprocessed with build and variant information.
+
+ 10) Added backlight support. The backlight may be
+ either timed or untimed. Should the timeout
+ be reset whenever the machine is used?
+
+ 11) Made pointer clicks configurable separately from
+ key clicks.
+
+ 12) Added screen clearing on switch on if a password
+ is set.
+
+ 13) Added UserHal functions for PointerSwitchesOn,
+ CaseOpenSwitchesOn, and CaseCloseSwitchesOff.
+ Grouped these, together with the
+ AutoSwitchOffTime, AutoSwitchOffBehavior,
+ BacklightTime, and BacklightBehavior information,
+ into a new TOnOffInfo structure.
+
+ 14) Implemented switch off on case close and switch
+ on on case open on all platforms.
+
+ 15) Simon has implemented a visual simulation on WINS
+ of case closing. On WINS, F11 is also used to simulate
+ both closing and opening the case. You will
+ notice that, while the case is closed, keyboard
+ and pointer events have no effect. This is to
+ simulate the fact that normally you can't get to the
+ keyboard or screen under these conditions.
+
+ 16) Enhanced MARM switch on on pen down to take
+ account of the Hal variable PointerSwitchesOn.
+
+ 17) Solved Low battery bugs (HA-357, HA-362)
+
+2) Ann
+ 1) Test code changes:
+
+ i) Additional tests added to t_math tests for Pow10(). These show
+ that in all but one case inexact string to real conversion is due
+ to inexact calculation by Math::Pow10(). All tests in t_math check
+ for as much accuracy as possible.
+
+ ii) t_float tests are now consistent between WINS and ARM.
+
+ iii) Whetstone benchmark tests added
+
+ iv) t_r96 casting tests now include identity tests (which check
+ consistency with MSDEV in WINS). Casting to TInt tests changed
+ in line with changes to source code (ii below).
+
+ 2) Source code changes:
+
+ i) TReal96::MultEq() altered to do one shift rather than preparing
+ and then shifting to left. This avoids losing bits which may be
+ shifted off the end by preparation, but for which there is space in
+ the final postition.
+
+ ii) TReal96::operator TInt() changed to round towards zero to
+ comply with IEEE standard and Java requirements (also MSDEV).
+
+ iii) TReal96::Prepare() altered to check for zero sign or zero
+ mantissa. If so, preparation is not done. Im the latter case,
+ the mantissa is meaningless and in the second preparation would
+ result in an infinite loop which does nothing.
+
+3) Morgan
+ 1) Implemented Kernel Faulting.
+ 2) Reorganised low memory to include the Registry just before the
+ Ram Drive. This means that the Ram Drive is shoved up and down
+ in memory as the Registry changes size.
+ Added class TLowMemory to manage the Ram Drive and Registry
+ memory allocation and to provide information to F32 about the
+ drive's changing position.
+ 3) The Ram Drive now survives Warm Resets and Kernel Faults
+ Implemented CPersistantRegistry to do the same for the Registry.
+ T_RESET tests all this jiggery pokery on MARM.
+ 4) Added integer divide by zero exception to MARM
+ 5) Implemented a user side mini-loader for loading Dlls from ROM
+ when an explicit ROM path is provided.
+ eg. lib.Load(_L("MONKEY.DLL"), _L("Z:\\Animals\\Primates\\Hairy"));
+ This eliminates most of the time taken to load these Dlls.
+
+4) Jane
+
+ 1) Fixed MMU bug which showed up in fairly obscure kernel growth/shrinkage
+ situations.
+
+ 2) Optimised page allocator for faster kernel growth.
+
+ 3) Added a routine to compact kernel pages when the machine is reset. This function
+ is not called yet, except in test code.
+
+ 4) Made a TFindChunk::Open() actually add the chunk to the process address space (unless
+ it is a kernel chunk) so that the chunk can be read/written from another process.
+
+5) Matthew
+ 1) Fixed HA-355: added %*a and %*b to TTime::Format() which give
+ am/pm without a space.
+
+ 2) Fixed HA-367: descriptor formatting now accepts things like
+ %-10f (default fill character space) and % 5F (no "+").
+
+ 3) Internal changes to sound driver to reduce the amount of clicking.
+ Also fiddled with the volumes of DTMF dialling, so it should work now.
+
+
+Version 0.01.086
+================
+(Made by Matthew, 22nd January 1997)
+
+This release is binary compatible with 085
+
+1) Graham
+ 1) Renamed T_PARSE to T_TPARSE to eliminate the
+ conflict with the F32 test program of the same
+ name.
+ 2) Updated the TREALTIM test programs and fixed some
+ super thread bugs.
+ 3) Temporarily reintroduced page-based ROM mapping so
+ that debugging can be tested again.
+ 4) Fixed a bug in the user side event code which
+ prevented position information being extracted
+ from the new EPointerSwitchOn events.
+ 5) Fixed bugs in the ARM implementation of
+ TInt64A::MulTop() and changed it to return a TInt.
+
+2) Ann Windsor
+ 1) Removed KTReal96MaxExponent and KTReal96MinExponent from
+ e32math.h
+
+ 2) Fixed bug HA-345: constants now correct to full precision.
+
+ 3) In t_math test code, all approximate tests now use the
+ function testApprox(). This tests that the relative error
+ is within a specified tolerance.
+
+ 4) Removed all approximate tests from t_r96 and t_r64.
+
+ 5) In Pow10(), limits for second underflow check changed so
+ 1.0E-308 underflows as expected.
+
+ 6) TInt64A::Multop() fixed to carry from insignificant parts
+ and now returns a TInt to indicate whether the insignificant
+ 64 bits are zero or non-zero. TInt64::MulTop() changed
+ accordingly.
+
+ 7) TReal96::DivEq() fixed to force rounding up where
+ appropriate. This results in division being up to
+ 5E-6 secs slower in the worst case.
+
+ 8) SReal64 and SReal32 struct definitions added to um_std.h
+ and removed from other umath *.cpp files
+
+ 9) TReal96::MultEq() fixed to force rounding up where appropriate.
+
+3) Alastair
+ 1) Fixed bugs in release versions of T_SEC.
+
+4) Simon
+ 1) Protected EventQ from access from WINS Window and Timer threads.
+ Fixes a few WINS Bugs related to AddEvent causing an Access
+ Violation.
+
+ 2) Added some new shutdown code to allow System threads to continue
+ execution when the machine is off. This fixes bugs like "Program
+ does not exit when minimized" and other miscallaneous hangings
+ after a PowerDown.
+
+ 3) Change to E32Initialize to allow WINC apps to call it more than
+ once.
+
+5) Matthew
+ 1) Stopped WINS from adding 1 hour for summer time when it's winter.
+
+ 2) Fixed bug in CRegistry::SetContents().
+
+
+Version 0.01.085
+================
+(Made by Jal, 10th January 1997)
+
+1) Morgan
+ 1) Fixed OOM alloc heaven in CreateSession and RLoader::LoadLibrary
+ 2) Renamed kernel.exe to ekern.exe in the X86 obey file so device
+ drivers can link to it.
+ 3) Added iLanguage bitfield and iHardware members to TRomHeader.
+ Updated BOOTROM.BIN to match.
+
+2) Jane
+ 1) E32 Proposals
+ a) Made CObjectCon::ValidateName -> User::ValidateName (static)
+ b) Removed copy constructors for TPoint, TSize, TRect
+ c) Made TLocale constructor exported, removed setting to 0 from TChar
+ constructor.
+ d) Removed CDeltaTimerAlloc
+ e) Americanised Capitalise.
+ f) Make TDesC8::Length and TDesC16::Length inline
+ g) Implemented Rog's amendment of David's User::Notify proposal: an RNotifier
+ class with the following member functions-
+ TInt Connect();
+ void Notify(const TDesC& aLine1,const TDesC& aLine2,const TDesC& aBut1,const TDesC& aBut2,TInt& aButtonVal,TRequestStatus& aStatus);
+ TInt InfoPrint(const TDesC& aDes);
+
+ 2) Bug fixes
+ a) Removed unused User time/date functions
+ b) Kept a list of thread relative threads within the thread so that they
+ can be closed properly when the thread dies.
+ c) Alloced a bit in the DThread iFlags for whether the thread is the main one, this
+ fixed the bug with APPRUNs not dying.
+ d) The priority of the NULL thread was incorrect in WINS - spotted by
+ David Batchelor, thanks.
+ f) Added CServer::Restart() and fixed CServer::RunL()
+ g) Fixed HA-55 kernel alloc heaven causes kernel re-entrancy
+
+3) SteveG
+ 1) Fixed bug in the battery recharger hanging when free'd. Added
+ iChargeTick.Cancel() into the device driver destructor.
+
+4) Geert
+ 1) Inlined various TDateTime, TTimeIntervalXxx and TTime members.
+
+ 2) Integrated Bruce's TTime::Parse() service. (See the proposal and
+ spec in E32 Proposals for details.)
+
+ 3) Removed all Time member functions duplicating services in TTime.
+
+ 4) Removed initialisation code from TTimeIntervalXxx's and TTime's
+ default ctors. Default constructed instances of these classes now
+ have undefined, arbitrary values.
+
+5) Graham
+ 1) Added functionality to the text window server to allow raw
+ event information to be passed through to a client. The
+ primary user of this is the final test program which
+ needs some way of testing each raw keyboard element.
+
+ 2) Updated the double multitasking kernel functions to give
+ handles wrt the kernel server rather than the device
+ driver client. Updated the real time test program and
+ device driver accordingly.
+
+ 3) Made relocatable static data changes appropriate for
+ our real-time needs.
+
+ 4) Fixed a further digitiser problem. There should
+ now be no machines which experience complete
+ digitiser failure apart from those with hardware
+ faults in this area.
+
+6) Alastair
+ 1) Added overloaded NewL function for Security class which
+ takes a piece of security data as a parameter so that a
+ CSecurityBase object can be constructed using security
+ data stored in a file for decryption purposes.
+
+ 2) Removed ConstructL, EncryptL, DecryptL and
+ IsValid functions from CSecurityBase API.
+
+ 3) Added NewEncryptL and NewDecryptL functions to
+ CSecurityBase API so that objects for handling encryption
+ sessions and objects for handling decryption sessions can
+ be created. The APIs for these object classes -
+ CSecurityEncryptBase and CSecurityDecryptBase - have been
+ added to E32BASE.H.
+ NewEncryptL and NewDecryptL take an initialisation
+ vector as a parameter to allow for pluggability with
+ more sophisticated encryption methods.
+
+ 4) Written a new UB_SEC.CPP to cater for the above
+ changes. The current encryption scheme produces
+ encrypted data in multiples of 32 bytes.
+
+ 5) Rewritten T_SEC.CPP to test security changes.
+
+7) Matthew
+ 1) Changed set and free tls functions from exec to sv calls.
+
+ 2) Fixed alloc heaven in change notifier, and changed notifier so that
+ you can only logon once to each notifier, so that the kernel's notify
+ function can be called from exec functions. This has meant API changes,
+ and the RUndertaker API has also been changed - the parameter has been
+ removed from LogonCancel - so the two are more similar.
+
+ 3) Added iMaxVolume capability to sound driver, now the volume-by-value
+ takes a value from 0 to iMaxVolume, instead of 0 to 100.
+
+ 4) Removed Time::IsValidDate().
+
+8) Pete
+ 1) Added custom and variant DLL for rack D h/w.
+
+ 2) Moved sections of code relating to the Pc Card Controller h/w out of
+ the Kernel DLL and down into the Variant DLL.
+
+ 3) Added the function UserHal::DriveInfo() which
+ returns a TInfoName for each local drive and Pc Card socket as well
+ as the total number of valid drives and socketss on a given variant.
+
+ 4) Various changes to the member functions of UserPcCardCntrl
+ class.
+
+9) Ann Windsor - CHANGES TO MATHS SOURCE CODE
+
+I e32\inc\e32math.h
+-------------------
+1. Constants KTReal32MinExponent and KTReal32MinExponent, KTReal96MaxExponent,
+KTReal96MinExponent, KTReal96ExponentBigBad and KTReal96ExponentSmallBad added.
+
+2. Functions added to UM_R96.CPP added to TReal96 class
+
+II e32\inc\e32std.h
+-------------------
+1. Constant KErrDivideByZero added.
+
+2. New constants defined for flags in TRealFormat type:
+ KExtraSpaceForSign=0x40000000
+ KAllow ThreeDigitExp=0x20000000
+ KUseSigFigs=0x10000000
+ KDoNotUseTriads=0x08000000
+ KGeneralLimit=0x04000000
+ KRealFormatTypeFlagsMask=0x7c000000
+ KRealFormatTypesMask=0x0000007
+
+3. RealFormatType no longer enum; changed to constant TInts
+ KRealFormatFixed=1
+ KRealFormatExponent=2
+ KRealFormatGeneral=3
+and two new types added:
+ KRealFormatNoExponent=4
+ KRealFormatCalculator=5
+
+4. iDecimalPlaces member of TRealFormat name changed to iPlaces because used
+for decimal places or significant figures as appropriate.
+
+5. TLex8 member function ScndigAfterPoint() added.
+
+
+III e32\ucdt\uc_des.cpp
+----------------------
+1. Changed in line with changes to e32std.h above.
+
+2. AppendFormatList() altered to allow three-digit exponents in E,e (exponent)
+and G,g, so Printf %E,e,G and g all display numbers to the maximum range.
+
+
+IV e32\umath\um_dtor.cpp
+------------------------
+1. Changed TLex8::Val() appropriately to deal with the full range of values. This
+includes doing multiplications in TReal96's so that errors can be detected.
+
+2. TLex8::ScndigAfterPoint() added to do conversion from decimal after point, so that
+trailing zeros are not included. This ensures that e.g. 0.2900 and 0.29 have the same
+binary representation.
+
+
+V e32\umath\um_pow.cpp
+-----------------------
+1. Changed to check for aSrc being ±1. If so, sets result appropriately to ensure exact
+and to save running algorithm.
+
+2. Bug found and fixed: Int() being used for a number potentially larger than 32767.
+Altered to return an error if Int() reports an error, i.e. if the input has an absolute
+value larger than 32767 (a return value larger than 32767 would lead to an error later in
+the function anyway). This ensures that results over and underflow as expected.
+
+3. Bug found and fixed: reduce() set high part of f to 0 rather than leaving it unchanged.
+This fixes the bug reported in B4 problem report no HA-207: overflows are now reported as
+expected.
+
+
+VI e32\umath\um_pow10.cpp
+-------------------------
+1. Changed to handle the full range of TReals rather than up to 1e±100.
+
+
+VII e32\umath\um_r96.cpp
+------------------------
+1. Set() checks that exponent does not exceed maximum (KTReal64ExponentBigBad/
+KTReal64ExponentBigBad) and is not less than minimum (KTReal32ExponentSmallBad/
+KTReal64ExponentSmallBad). If so, KErrArgument is returned.
+
+2. GetTReal()
+i) In checking for underflow, value against which check is made changed from
+-KTReal32MaxExponent/-KTReal64MaxExponent to KTReal32MinExponent/KTReal64MinExponent.
+ii) Rounding has been implemented for TReal32s so that when a TReal96 mantissa is
+converted to a TReal32 it is rounded to the nearest value using all bits available,
+rather than just being truncated.
+
+3. Casting to a TInt from a TReal96 changed to check for zero by using sign and also to
+round to nearest, rather than always rounding down.
+
+4. Arithmetic
+i) Added functions AddEq(), SubEq(), MultEq() and DivEq() which perform the operations
++=(), -=(), *=() and /=() respectively, as these operator functions did previously, but
+reporting an error constant, rather than panicking.
+ii) Similarly to i), functions Add(), Sub(), Mult() and Div() have been added as the
+non-panicking variants of operator +(), -(), *() and /(). The latter functions panic on
+an error as described in ii). The result is written to an input target variable.
+iii) operator +=(), -=(), *=() and /=() perform arithmetic operations (using AddEq(),
+SubEq(), MultEq() and DivEq() respectively) and either panic (when unsuccessful), leaving
+the initial arguments unchanged, or otherwise return the result in *this.
+iv) Added function CheckOverUnderflow(), to be used in AddEq(), SubEq(), MultEq() and
+DivEq(), to check for overflow or underflow in cases where it may occur by normalising
+the result and checking the exponent.
+v) Added function PanicOverUnderflowDividebyZero() which is used in operator +=(), -=(),
+*=() and /=() to panic if an error is returned by AddEq(), SubEq(), MultEq() or DivEq()
+respectively.
+vi) Addition operations (in AddEq()) improved to eliminate loops which change exponent by
+1 and shift the mantissa by 1 place on each loop to make the exponents equal before
+addition takes place, instead altering the exponent and shifting as appropriate in one
+step.
+vii) Fixed bug in AddEq() so that it shifts the mantissa of the bigger number right by
+one. This prevents failure when subtracting numbers of the same sign (or adding numbers
+of the opposite sign) when the ms bit needs to be carried down (and hence only two bits
+are shifted down into the extended part when preparing the result) and the last hex digit
+of the result is 4 when prepared.
+viii) In DivEq(), a new error KErrDivideByZero has been introduced. Also reports
+KErrArgument if 0/0 (invalid operation).
+
+5. Changed Normalise() to round on last three bits to nearest value, rounding to value
+with l.s. bit zero (even) if two values are equally near to be consistent with MSDev and
+to minimise propagation of rounding errors in general.
+
+6. To be consistent with MSDev, increment and decrement operators should normalise after
+each operation. However, this doubles the time and ultimately decreases accuracy, so
+has not been adopted.
+
+
+VIII e32\umath\um_rtod.cpp
+--------------------------
+1. fDigLim() changed to handle all exponents between -1022 and 1025, i.e. all TReal64s.
+
+2. All do...() functions now take TInt flags as one of their parameters to enable (or
+disable) extra space for sign, three-digit exponents, significant figures rather than
+decimal places, triads and linited accuracy of digbuf.
+
+3. In addtition to the flags above, an internal flag determining whether the digbuf needs
+rounding has been added.
+
+4. doExponent() altered so it can be used both directly and by doGeneral() and
+doCalculator(). In calculator mode, trailing zeros are eliminated. Also uses three-
+digit exponents if allowed by flag if necesary.
+
+5. doFixed() altered so that a space is left for a potential sign if a flag is set. This
+allows positive and negative numbers of the same exponent to be of the same accuracy.
+
+6. doGeneral() altered in line with alterations to doFixed() and doExponent().
+
+7. doNoExponent() new function added to deal with calculator representation which does
+not use exponents, i.e. numbers to a maximum number of significant figures. This
+function is similar to doFixed(), other than it does not pad with zeros and hence does
+not necessarily have a decimal point or deciaml places. If the triad length is non-zero
+then triads are allowed by default (but can of course be disabled by a flag). An
+overflow error is reported if the number is too big to fit in the maximum significant
+figures and an underflow if it is too small for any significant digits to appear i.e.
+apparently 0. If the number does not fit, i.e. not enough space for sign, point or triad
+separators, then a general error is reported.
+
+8. doCalculator() new function added which operates as a conventional calculator would,
+i.e. using non-exponential representation as far as possible and otherwise exponential
+representation. The number of figures in the display is limited by the maximum
+significant figures. This function will report a general error if there is insufficient
+space availble to include a sign, decimal point and exponent, as well as the figures,
+EVEN IF THEY ARE NOT REQUIRED. In this way it operates as a conventional calculator.
+doCalculator() uses either doNoExponent() or doExponent() (in calculator mode, see 4.)
+as necessary.
+
+9. rtob() has been altered in line with the above changes.
+Also it now checks that the numspace is >0, otherwise reporting a general error. iType is
+now used to take both the user-specified flags and type. If no type or flags are
+specified then it leaves. Flags are also set as necessary for the various modes (in all
+modes, rounding is needed):
+ fixed - does not use significant figures
+ exponent - does not use significant figures (when accessed directly rather than
+ through calculator)
+ general - does not use significant figures or triads
+ no exponent - uses significant figures
+ calculator - uses significant figures and no triads.
+
+
+IX e32\umath\um_sin.cpp
+-----------------------
+1. sinx() changed to ensure than sin of a multiple of pi and cos of an odd multiple of pi/2
+give exactly zero.
+
+
+X e32\umath\um_std.h
+---------------------
+1. EMathUnknownPanic added to TMathPanic to deal with unknown errors.
+
+
+XI e32\umath\um_tan.cpp
+-----------------------
+1. Tan() changed to ensure that tan of a multiple of pi gives exactly zero and tan of an
+odd multiple of pi/2 reports an overflow error.
+
+
+XII e32\umath\um_utl.cpp
+------------------------
+1. Poly() changed to use TReal96s.
+
+
+XIII e32\upmarm\up_gcc.cpp
+--------------------------
+1. Arithmetic now raises an exception if an error is returned by the TReal96 non-
+panicking arithmetic variants.
+
+
+XIV e32\upwins\up_i64.cpp
+-------------------------
+1. Bug found in MulTop() - the two least significant words are never multiplied together
+and hence the possible carry from this part into the ls word of the result is ignored.
+This part may also need to be used for rounding purposes.
+
+
+CHANGES TO MATHS TEST CODE
+--------------------------
+I T_FLOAT
+---------
+1. Altered and increased appropriately to test altered and new cases due to changes
+in the above. Also divided into two modules containing data only (FLTDATA1.CPP and
+FLTDATA2.CPP) and a header file containing class definitions because the amount
+of initialised data was too large for the GCC compiler.
+
+2. Altered and increased appropriately to test fully string to real conversion to
+full range. N.B. THESE TESTS ARE CURRENTLY APPROXIMATE DUE TO AN UNRESOLVED BUG.
+
+
+II T_GEN and T_GEN32
+--------------------
+1. Added to generate files for use by T_R64 and T_R32. These are for testing in
+ARM, to see that the GCC and MSDEV compiler give the same results.
+T_GEN also generates special values needed for the generation of these files and
+for T_R32 and T_R64 test code.
+
+
+III T_MATH
+----------
+1. In the light of changes made to sin, cos, tan and power functions various tests have
+been added or updated:
+i) tests exact results are given for: zero to a power, any number to power zero, ±1 to
+any power, sin(n*pi), cos((2n+1)*pi/2) and tan(n*pi) (where n is an integer).
+ii) tests overflows occur as expected for Math::Pow()
+iii) tests tan((2n+1)*pi/2) overflows.
+
+2. More comprehensive tests of trig functions have been included to test multiples of
+"common" values: pi/6, pi/4, pi/3, pi/2 and pi (in addition to test for exact values
+above).
+
+3. Comprehensive testing of Math::Cos() (not just Sin() ) have been added.
+
+4. Added test to check reduce() is working correctly.
+
+
+IV T_R64 and T_R32
+-------------------
+1. Special values generated by T_GEN and T_GEN32 used in all tests.
+
+2. Casting tests for TReal32s now use TReal96s. (A special test following this shows the
+occurrence of an (as yet unresolved) bug.) Tests have also been added to be used when
+exception handling is fully implemented.
+
+3. All tests improved and made comprehensive.
+
+4. Further tests added using the files generated as described in II.
+
+5. T_R64.CPP and T_R32.CPP have also been split so their data is in a separate file
+to avoid duplication of code in T_GEN and T_GEN32.
+
+6. Arithmetic tests all test for equality rather than using BitApprox, with cases
+which fail being removed until bugs are fixed so exact results are obtained in all cases.
+With changes to um_r96.cpp explained in VII 2. and 4. above, T_R32 tests are now all
+exact.
+
+7. Test code has been included (for use in debug mode only) to test that exceptions
+are raised correctly by the up_gcc.cpp code (which has been copied into separate files -
+emgcc32.cpp and emgcc64.cpp - which may be called by these tests).
+
+
+V T_R96
+--------
+1. Special values for use in the test code have been initialised and used in the tests
+where appropriate.
+
+2. Constructors of TReal96s from TInts, TReal32s and TReal64s tested fully, including
+tests that attempting to construct from values with "bad" exponents (i.e. exponents too
+big or too small) results in a return of KErrArgument.
+
+3. Test of preparing a denormal checks that the value is not already prepared. Also added
+test of preparing of an unprepared value.
+
+4. Arithmetic tests
+i) Arithmetic tests all test for equality rather than using BitApprox, with cases
+which fail being removed until bugs are fixed so exact results are obtained in all cases.
+ii) As a result of the bug fixed in operator/=() by Jal a test of division of denormals
+has been added.
+iii) Extra tests have been added to test the new member functions AddEq(), SubEq(),
+MultEq() and DivEq() which perform arithmetic operations and report an error rather than
+panicking if overflow, underflow or division by zero errors occur. The panicking-variants
+are also tested to be sure panics occur as expected (to be run in debug only).
+
+5. Tests of GetTReal(), casting functions unary operators, increment and decrement
+operators and equalities and inequalities have been made more comprehensive and include
+tests for overflow, underflow and total loss of precision errors where appropriate.
+
+6. Tests for SetExp() and SetSign() and also for assignment operators added.
+
+7. Increment/decrement tests now include normalising to get results consistent with
+Microsoft.
+
+Version 0.01.082
+================
+(Made by Morgan, 20th December 1996)
+
+This release is binary compatible with 081
+
+1) Morgan
+ 1) Fixed a bug in the SWI vector code on the ARM that was calling
+ dispatchDfcAndReschedule incorrectly.
+
+2) Jane
+ 1) Changed the base addresses of WINS dlls as suggested by Martin Budden.
+
+ 2) Fixed bug in CObjectIx where creating many objects could return a null handle.
+
+ 3) Fixed Daylight saving bug in WINS
+
+3) Graham
+ 1) Modified bootup code so that it reads the keyboard to
+ set up ROM memory configuration. This will be used with
+ the masked ROM to check paged mode rom access
+
+
+Version 0.01.081
+================
+(Made by Matthew, 17th December 1996)
+
+This release is binary compatible with 080
+
+1) Matthew
+ 1) Fixed dereferencing-zero bug in CObjectCon and CObjectConIx destructors.
+
+ 2) Changed EDLL WINS debug info to C7 format.
+
+
+Version 0.01.080
+================
+(Made by Jane, 16th December 1996)
+
+This release is binary compatible with 079
+
+1) Morgan
+ 1) Timers abort on power up and locale changes to universal
+ time, and daylight saving.
+ 2) Fixed HA-307
+
+2) Matthew
+ 1) Speeded up several CObjectIx, CObjectCon and CObjectConIx
+ functions by using pointers into arrays instead of operator[].
+
+3) Jane
+ 1) Added support for real time threads. These are supervisor mode threads
+ whose real time response is greatly improved over ordinary user threads,
+ as it is possible for them to interrupt the supervisor server and
+ non-blocked slow exec calls.
+ Wrote the WINS and X86 implementations of the above, and a test driver
+ and test program. (D_RTIM and T_RTIM).
+
+4) Graham
+ 1) Added ARM implementation of real time threads.
+
+Version 0.01.079
+================
+(Made by Graham, 10th December 1996)
+
+This release is binary compatible with 078
+
+1) Graham
+ 1) Changed the bootstrap to map the ROM using ARM MMU 1Mb
+ sections. This reduces the number of TLB entries used
+ by the ROM and yields a 4% speed increase on our inter-
+ process message passing test (T_PROC1).
+
+ 2) Fixed MachineInfo problems on WINS (HA-220, HA-303).
+
+ 3) Patched up some Hal information services.
+
+ 4) Experimentally added clicks when the digitiser is touched.
+
+2) Matthew
+ 1) Checked all PP::, KK::, Plat:: Panics and Faults. Some
+ have been changed to panic the calling thread, instead of
+ the kernel. This fixes bugs like HA-276 (Leave without TRAP).
+
+
+Version 0.01.078
+================
+(Made by Graham, 7th December 1996)
+
+This release is binary compatible with 077
+
+1) Simon
+ 1) Changed WINC over to use some WINS components, allowing
+ Store and other components to use WINS librraies for WINC
+ development.
+
+ WINC now conists of a EKERN ECONS and EEXE but all other
+ components are taken from the WINS build. The BLD.CMD has
+ been changed to reflect this new building model.
+
+ 2) WINS EUSER added WINC initialisation functions.
+
+ 3) Removed unecessary files from UPWINC
+
+2) Graham
+ 1) Implemented User::MachineConfiguration() and
+ User::SetMachineConfiguration(). These may be used to
+ save and restore the registry and O/S information such as
+ whether key clicks are enabled or sound volume is loud etc.
+ It is hoped that this information will now be standardised
+ in such a way that anyone moving from one EPOC/32 machine
+ to another will be able to transfer their machine's
+ 'personality' in one go.
+
+ 2) Moved P::DebugMask() to Plat::DebugMask() as it was being
+ exported.
+
+3) Pete
+ 1) PC Cards are now powered down automatically after 5
+ seconds if the card is left both un-configured and with no memory
+ allocated.
+ 2) Fixed a problem were a CF Card was incorrectly returning
+ 'Not supported' on each subsequent access following the
+ situation were a read from the card was interrupted with a media
+ change. (Unfortunatley interrupted writes still cause the file server
+ to panic).
+ 3) Full 16bit access of CF cards (and therefore support of Hitachi
+ cards) now takes place when a Rev2 Etna is detected.
+ 4) General PC Card related class renameing. Also, PC Card
+ configuration info. has now been moved from the EKERN into the
+ appropriate custom DLL for ARM builds.
+
+
+Version 0.01.077
+================
+(Made by Graham, 6th December 1996)
+
+1) SteveG
+ 1) Fixed bug in battery charging LDD which hung when free'ing the
+ device driver. Removed debug information which was being
+ output to the comms port while charging was in progress
+
+2) Morgan
+ 1) Altered the MARM MMU PTE permissions lookup table to enable
+ write buffers for user data. Fixes HA-300 (Speed).
+ 2) User::Abort now raises EExcKill exception.
+
+3) Jane
+ 1) Fixed Lane's shared chunk growing problem
+
+4) Graham
+ 1) Fixed a versioning problem with the text window notifier
+ server.
+
+Version 0.01.076
+================
+(Made by Graham, December 3rd 1996)
+
+This release is binary compatible with 075
+
+1) Graham
+ 1) Added Eiger port control code which avoids output bits
+ reading erroneously when they are connected to circuits
+ with large rise or decay times.
+
+ 2) Added Minor Version 4 to the E32 version number to reflect
+ the fact that this is a B4 release.
+
+ 3) Fixed a problem in the media driver version numbering.
+
+2) SteveG
+ 1) Preliminary release of the battery recharging LDD, DARCP1.LDD,
+ for tests by the hardware dept. This is only for the real
+ Proteas.
+
+ The LDD offers the following functions:
+
+ RDevNicads::Open() to open a channel
+
+ RDevNicads::Type(TInt& type) to get the charge type in progress
+ This will be EChargeNone, EChargeFast or EChargeTrickle
+
+ RDevNicads::SetChargeType(TInt aType) to set the type
+ The type should be EChargeNone, EChargeFast or EChargeTrickle.
+ Returns an error if it is not possible to start the requested
+ charging method.
+
+ RDevNicads::Close()
+
+ The functions are defined in D32RCHG.H and D32RCHG.INL
+
+ Loading the device driver using LoadLogicalDevice will start
+ the charging if a rechargeable battery pack is fitted. The mains
+ LED will flash while fast charging is in process. Once fully charged,
+ the battery pack is trickle charged while mains power is applied.
+ This can be overridden using the above functions.
+
+3) Morgan
+ 1) Fixed WINS so that it reports the same physical screen
+ size as it did before .INI-file-controlled fascia bitmaps
+ were introduced.
+
+Version 0.01.075
+================
+(Made by Graham, November 28th 1996)
+
+This release is not binary compatible with any previous version.
+
+1) SteveG
+ a) Wrote the device driver for the serial E2PROM. This is currently
+ only for P1 Proteas, as the racks do not have the device fitted
+
+ The device driver is DAE2P1.LDD and provides all the commands
+ necessary for writing, reading, protecting and locking the
+ sixteen 16-bit registers in the E2PROM chip
+
+ b) Fixed bug in ARM Mem::Compare with non word aligned buffers >=16
+
+ c) Implemented keyboard repeats in the E32 text WServ
+
+ d) Added an EActive event, which is sent in WINS when the focus
+ is returned to the WINS window. The EInactive event is still
+ sent when the WINS window loses focus
+
+ e) Added an EUpdateModifers event, which is sent whenever the
+ WINS window gains focus. This event includes the current
+ state of the toggling modifier keys, and should be passed
+ on to the keyboard translator to update its modifier states
+ using KeyTranslator->UpdateModifiers(TInt). The modifiers
+ are extracted from the event using TInt TRawEvent::Modifiers();
+ E32 text WServ modified accordingly. This event is sent before
+ the EActive event. This event will also be sent when booting
+ up WINS, so the caps/num lock states will be correct at bootup.
+ KeyTranslator->UpdateModifiers() also resets the state of the
+ key translator to normal
+
+ f) Implemented keyboard clicks, the following UserHal functions
+ can be used to set the clicks:
+
+ to set/read the volume:
+ UserHal::SetKeyClickLoud(TBool)
+ UserHal::KeyClickLoud(TBool&)
+
+ to set/read if clicks are enabled:
+ UserHal::SetKeyClickEnabled(TBool);
+ UserHal::KeyClickEnabled(TBool&);
+
+ to override the system on/off setting, forcing clicks off
+ (will be used by WServ to turn off clicks when an application
+ requests to disable clicks while in foreground):
+ UserHal::SetKeyClickOverriden(TBool)
+ UserHal::KeyClickOverriden(TBool&)
+ (This function could do with a better name...:-)
+
+ Using SetKeyClickOverriden(ETrue) will disable key clicks
+ regardless of the system setting. The system setting can
+ still be changed while overriden.
+
+ Note that key clicks will not work in WINS as they produced
+ more of a key fart than a click. The functionality is there,
+ and if a way of producing a suitable click is found, will be
+ added in a later release (function P::KeyClick() in KP_UTL.CPP)
+
+ g) Fixed problem with CTimers going off 1 second early - this
+ solves the problem of alarms going off a second or so early
+ in TimeW app on MARM. There still appear to be problems
+ in WINS, which may lie elsewhere...
+
+ TSecondLink::At() now converts the absolute time you specify
+ to seconds since year2000, and uses this to work out the
+ delta value to put into the queue. This is more accurate
+ since the time that the queue was last ticked over is also
+ stored in seconds since year2000. Previously the value added
+ to the delta queue was the difference between the system time
+ and the time you supplied, which could be upto a second out
+ if the microseconds part of the system time was non-zero
+ which would be 99.9999% of the time
+
+2) Morgan,
+ a) Added support for a WINS system ini file allowing some system defaults
+ to be setup. The .INI file lives at \EPOC32\DATA\SYSTEM.INI
+ and allows you to change the screen dimentions, fascia and the
+ LED arrangement.
+ The defaults are
+ ScreenWidth 640
+ ScreenHeight 240
+ ScreenOffsetX 123
+ ScreenOffsetY 53
+ FasciaBitmap \epoc32\data\Fascia.bmp
+ LedOffsetX 30
+ LedOffsetY 26
+ LedSize 14
+ LedGap 5
+ LedArrangeHorizontally
+ #LedArrangeVertically
+
+ b) Added exception support for MX86, MARM, and WINS:
+
+ TExceptionHandler* RThread::ExceptionHandler() const;
+ TInt RThread::SetExceptionHandler(TExceptionHandler* aHandler,TUint32 aMask);
+ void RThread::ModifyExceptionMask(TUint32 aClearMask, TUint32 aSetMask);
+ TInt RThread::RaiseException(TExcType aType);
+ TBool RThread::IsExceptionHandled(TExcType aType);
+
+ If a thread has no handler for an exception it is passed onto the
+ kernel for handling. The default action is to panic the offending
+ thread. Unhandled exceptions caused by RThread::RaiseException()
+ force the thread to exit via User::Exit().
+ Otherwise handlers are executed in the context of the thread on
+ which the exception is raised and control returned to the
+ point of the exception.
+
+ When debugging under WINS, MSDEV will intercept the exception before
+ the handler has a chance to execute.
+
+ c) Fixed HA-258
+
+ d) Added Uids (and -type-safe-link for ROMBUILD) to the Base components under ARM.
+ The Uids are #defined in \Epoc32\include\E32UID.H and \e32\kbarm\E32UID.IBY.
+
+ e) Added an iTextSize to TLoaderInfo and TRomImageHeader for GDB
+
+ f) Implemented Dll::GlobalAlloc, Dll::GlobalAllocated, Dll::GlobalRead, and
+ Dll::GlobalWrite.
+
+3) Matthew
+ a) Fixed HA-208 (IsPresent and IsValid in TUidType should return TBool).
+ Also changed loads of other Is*() functions to return a TBool instead
+ of a TInt. A few Is*() functions which returned KErr values have been
+ renamed:
+
+ CObjectCon::IsValidName -> ValidateName
+ CObjectCon::IsUniqueFullName -> CheckUniqueName
+ DComm::IsValid -> Validate
+
+ b) Fixed HA-196 (inline TLocale functions not expanded in release builds).
+
+ c) Fixed HA-238 (Shortcomings of KNullUid definition): removed TUidC class
+ and added static functions TUid::Uid(TInt) and TUid::Null() to get round
+ GCC bug. #defined KNullUid as TUid::Null().
+
+ d) Changed WINS Uid scheme so that the UId is stored in a segment of its own
+ called ".E32_UID", to add a UID to a windows file include the code
+
+ #pragma data_seg(".E32_UID")
+ __WINS_UID(Uid1,Uid2,Uid3)
+ #pragma data_seg()
+
+ in your source.
+
+ e) Added the capability to detect thread death to the RChangeNotifier
+ (completes with the EChangesThreadDeath bit set).
+
+ f) Implemented User::InfoPrint() function. Also added a very simple notifier
+ server to the text window server so that little windows appear when
+ anyone calls User::Notify or InfoPrint.
+
+ g) Improved the Tls scheme so that it uses a CArrayFixFlat. According to my
+ benchmarking this should speed up Dll::Tls(), though it remains to be
+ seen what happens in the real world.
+
+ Note that there is now a Dll::FreeTls() function, and that Dll::SetTls
+ can now return KErrNoMemory.
+
+ h) Changed midnight crossover code, to avoid costly divisions.
+
+ i) Changes to sound driver: Fixed several bugs to do with having two LDDs
+ going at once. This has caused the driver to become more sensitive to
+ playing and recording at once, and may mean that code that previously
+ worked fine now returns KErrInUse. Remember that the driver keeps
+ playing aLaw even after the last play request has been completed, and
+ keeps recording until the buffer is full. If you find problems, check
+ that you flush the record buffer when you have stopped recording, and if
+ you try to record and get KErrInUse, you may want to wait until the play
+ buffer has had time to drain and try again before reporting an error.
+
+ Added some preliminary power handling code. Playing will stop on
+ switch-off and the restart from where it left off; recording will
+ terminate with KErrGeneral (this seemed the only appropriate value)
+ when you switch back on.
+
+ The PDDs now support EVolumeByValue. The values are as follows:
+
+ 0-20 = EVolumeNone
+ 21-40 = EVolumeSoft
+ 41-60 = EVolumeMedium
+ 61-80 = between EVolumeMedium and EVolumeLoud
+ 81-100 = EVolumeLoud
+
+4) Jane
+ a) Changed MMU from a scheme of passing 3 parameters denoting the chunk's
+ owner, its type (code, data etc.) and whether it was locked in physical or
+ linear memory, to a simpler scheme where the chunk's owner is passed throughout the MMU
+ system (there being a greatly increased possible number of chunk owners). This
+ was to enable the ARM MMU, which is more limited than the X86 one, to cope with
+ shared chunks being read only in one process and writable in another etc.
+
+ b) When creating certain types of chunks, kept a list of allocated pages, so that it
+ is possible to support 3 possible states of permissions. (On the X86 this is achievable
+ by merely changing the top level PDE permissions - this is not so on the ARM). This change
+ allows the ARM MMU to support code chunks which are read/write to start with when the file
+ server reads the code into them from a CF card, but later are both supervisor read/only
+ when in the home section and user read/only when running.
+
+ c) Made a note early on of the file server's process. Changed the ram drive chunk
+ to being two-state chunk, and when the file server runs, change the permissions on the
+ RAM chunk (top level PDEs only) so that the file server has direct access to the
+ RAM drive.
+
+ d) Made the RAM drive supervisor priviledges, so that no-one except the file
+ server (see above) can access it.
+
+ e) Added size reporting functions for spy programs
+ TInt RLibrary::GetRamSizes(TInt& aCodeSize, TInt& aConstDataSize);
+ TInt RThread::GetRamSizes(TInt& aHeapSize, TInt& aStackSize);
+ TInt RProcess::GetRamSizes(TInt& aCodeSize, TInt& aConstDataSize, TInt& anInitialisedDataSize, TInt& anUninitialisedDataSize);
+
+ f) Added Andrew Thoelke's optimisations to various Find and Locate functions - see
+ Notes for more details.
+
+
+5) Graham
+ 1) Added and enhanced Kazuhiro Konishi's unicode/japanese changes
+ to the text window server.
+
+ 2) Added the UID into the sound driver make file and removed
+ all the link dependancies that the sound PDDs had upon
+ their LDD.
+
+ 3) Fixed the dodgy digitiser (HA-284)
+
+ 4) Experimentally increased the digitiser sample rate to
+ 50 samples/s.
+
+ 5) Introduced the EPointerSwitchOn event. This event contains
+ x and y information and is generated when pen down causes
+ the machine to switch on. No further pen events should be
+ generated until the pen has subsequently been removed from
+ the surface of the digitiser. I believe appropriate windows
+ (i.e. the application bar window) will be able to register
+ with the window server an interest in these events. So, normal
+ windows should not be troubled by them. This should solve
+ problem HA-325.
+
+ 6) Removed the text window server's beep when switching on
+ normally and introduced it when switching on with the
+ digitiser. (This only occurs on debug builds).
+
+6) Rog 1) Fixed RackC COM::1 bug which was causing input RS-232 lines
+ to be reported incorrectly.
+7) Pete 1) Reduced the wait states introduced by Etna on CF Card
+ attribute memory reads. This was interfering with screen
+ refreshing when 16 shades of grey mode was enabled (HA285).
+ 2) CF card support when powering on and off the machine has
+ now been added. On power off, the card is fully powered down. On power
+ up, TLocalDrive objects are notified of the power down, forcing them
+ to re-mount the disk on the next access (HA281).
+ 3) Added the functions InCritical() and EndInCritical() to
+ the PC Card controller. While in-critical, media change power down is
+ delayed. Writes to the CF Card are now critical. Prior to this, if a
+ media change occured during a write to the card then this could leave
+ a sector with an ID error on the card.
+ However, there is currently a problem such that the File Server
+ panics if a media change occures during a write to the CF card
+ so this should be avoided for now.
+ 4) PC Card controller now able to access a CIS chain in common
+ memory as well as attribute memory.
+ 5) Removed the function User::PcCardCntrlInterface() and
+ replaced this with the class UserPcCardCntrl.
+ 6) Added the following functions to the above class: MediaStart(),
+ MediaOpen(),MediaInfo(),MediaRead(),MediaWrite(). These
+ allow access to a media device (eg CF Card) at a media
+ level (rather than a partition level as do TLocalDrive.Read() and
+ Write()). I.E. they allow access to the partition table etc.
+
+
+Version 0.01.074
+================
+(Made by Graham, November 6th 1996)
+
+1) Graham
+ 1) Fixed a leak in AddProtected() which caused the O/S to
+ panic with EBadDfc when stressed.
+
+ 2) Added followers into the TEiger class for ports A,B,C,D
+ and E. Modifying these registers can now be safely
+ achieved without worrying about those bits which are
+ programmed to be input bits.
+
+ 3) Added interrupt protection into all TEiger modify
+ functions.
+
+ 4) Stopped KE_ALL debug information from coming out in all
+ circumstances.
+
+2) Morgan
+ 1) Moved WINS power off button to F9 (HA-214).
+ 2) Fixed HA-255 and added test code.
+ 3) Made semaphore and mutex names unique for each process to fix
+ HA-163. It is now possible to run 2 WINS kernels with the same
+ process name simultaniously.
+
+Version 0.01.073
+================
+(Made by Graham, November 6th 1996)
+
+1) Graham
+ 1) Solved the stack problem which prevented debug information
+ from being emmitted in MARM debug builds.
+
+ 2) Fixed WINS keyboard repeat problem when the WINS window
+ loses focus.
+
+2) SteveG
+ 1) Reduced stack usage of CObject::FullName, which was shoving a
+ TFullName on the stack for every owner of an object. Now only
+ one TFullName is put on the stack regardless of the number of
+ owners. This cures HA-273.
+
+Version 0.01.072
+================
+(Made by Jane, October 25th 1996)
+
+This release is the candidate B3 release. Unless there are any show-stopping
+bugs, our next release will be the first in the chain leading to B4, and
+will not be binary compatible with this one.
+
+NOTE: Once again to speed the passage of this non-binary compatible release
+through the system, I have released with test code failures. However in this
+case I believe them to be test code problems. The following tests are failing
+with kernel alloc heaven - T_CHUNK (chunk testing), T_KHEAP (thread testing)
+and T_THREAD (undertaker testing). These tests fail in ARM debug builds only,
+and pass on X86, which leads me to believe that these are granularity
+issues in the kernel heap on ARM.
+
+1) Jane
+ a) Implemented allocation of sub-page tables for ARM.
+
+ b) Fixed bugs to do with lengths of supplied filenames in
+ process and library loading. Took the opportunity to rationalise
+ the loader to do this and reduce stack impact considerably.
+
+ c) Added MMU debug supervisor calls to enable the porting of my
+ MMU system from its emulated environment, and converted several
+ tests to the new system.
+
+ d) Tidied up various APIs to their correct places, ready for
+ unfreeze.
+ Affected are the new unimplemented exception APIS, and the
+ RLoader::LoadLibrary
+
+ e) Added an enum, TKernPanic, to e32std.h
+ Now client threads will be panicked with values in this list,
+ rather than error numbers.
+
+ f) Fixed a couple of bugs in the low-level arm mmu implementation which
+ showed up with very large RAM disks.
+
+ g) Exported wildcards KMatchAny and KMatchOne from e32std.h
+
+ h) Changed RConsole::Set to RConsole::Init
+
+ i) Stopped RTest writing to comm ports (except in X86 builds)
+
+ j) Rationalised KErrxxxx constants
+ KErrNoLinearMemory gone, used KErrNoMemory instead
+ KErrSubSystem gone
+ KErrDomain gone, used KErrArgument instead
+ KErrException gone (kernel panic enum used instead)
+ KErrNotFound becomes -1, so that we could omit KNotFound in future.
+
+ NOTE - KErrGeneral is no longer -1. This showed up quite a few
+ bugs in the file server which was assuming that KNotFound was the
+ same thing as KErrGeneral. This is no longer the case, beware!
+
+ k) Added RThread::ProcessPriority() and RThread::SetProcessPriority()
+
+ l) Changed void RThread::GetHeap(RHeap*&) to RHeap* RThread::Heap()
+
+ m) Speeded up interprocess messaging by about 10%. A further 8%
+ to come in next release.
+
+2) Steve
+ a) Fixed UserHal::MemoryInfo which was returning an incorrect
+ figure for FreeRam - it was deducting the size of the RAM
+ disk from the real free ram size.
+
+3) Graham
+ a) Changed the ADC interface to unsigned values. This should give
+ doubled digitiser accuracy but meant recalibration of the
+ digitiser on all platforms.
+
+ b) Updated K32VIDEO.H to include power handling functions.
+
+ c) Add CountDown(n) and FirstDelta() function calls to the
+ priority queue class.
+
+ d) Implemented waking up from alarms.
+
+ e) Implemented waking up from pen down.
+
+ f) Implemented ESwitchOn events on all platforms (HA-229).
+
+ g) Added a beep to the Text Window Server in debug builds
+ when an ESwitchOn event occurs.
+
+ h) Added a general purpose interface to the ADC channels which
+ measure battery voltages, thermistor readings etc.
+
+ i) Made Neil Lilliot's change for reducing shadowing on the LCD.
+
+4) Jal
+ a) Fixed a bug in TReal96::operator/=
+
+Version 0.01.071
+================
+(Made by Graham, October 11th 1996)
+
+1) Graham
+ 1) Added a millisecond timer queue to the kernel. It
+ currently uses FRC2. All kernel services which were
+ using TEiger::WaitMilliseconds should now move over
+ to the new services provided by this queue.
+ 2) Implemented the digitiser in terms of the millisecond
+ timer queue instead of the system tick queue. This enables
+ code to be written which can deliver more than 21 digitiser
+ events per second (it is currently set to 25/s). Not only
+ this, by driving current across the digitiser only when it
+ is absolutely necessary, power consumption has been
+ reduced. The digitiser should now work on upgraded
+ machines - the H/W fix for digitiser wobble involves an
+ increase to 1mS in the X/Y drive rise-time. In order to
+ take account of this rise-time, the millisecond timer was
+ required.
+ 3) Implemented the buzzer in terms of the millisecond timer
+ queue. Due to variable interrupt latency, this does not
+ produce a pleasing effect. So, for the time being, I have
+ left the buzzer monopolising FRC1. You can switch between
+ this and the new millisecond timer buzzer with the compile
+ time switch __SOFTWARE_BUZZER__ in KEARM\KE_UTL.CPP
+ 4) Introduced Hal::WaitMilliSeconds which uses the
+ millisecond timer. This replaces TEiger::WaitMilliSeconds.
+ 5) Added device driver power handling functions in
+ KS_POWER.CPP.
+ 6) Created a release of header files for those who link to
+ the E32 kernel (device driver writers mainly). This can
+ be found in R:\E32\ZIP\INCK.xxx
+ 7) Implemented the auto clibration sequence on the ADC
+ converter. This cures the problem which causes the first
+ ever pen down event to have the wrong y-coordinate.
+
+2) Pete
+ 1) Fixed a bug which prevented the machine booting up with
+ the CF card door open.
+
+Version 0.01.070
+================
+(Made by Jane, October 4th 1996)
+
+1) Morgan
+ 1) Priority of a process is set according to the Executable's E32Image.
+
+ 2) Fixed svLibraryLoadExact to deal with statically linked libraries where
+ the ownership of the libraries handle belongs to the newly created process.
+
+2) SteveG
+ 1) Changed the keyboard data for P1 to have ' on shift-6, not ^
+
+ 2) RDebug changes: Anyone can now request to be informed when a thread
+ panics, hits a breakpoint or causes an exception without having
+ called RDebug::Open. This means a panic catcher can be running
+ continuously and still allow GDB to be used. Previously, only one call
+ to RDebug::Open was allowed, meaning that the debugger could not
+ be used while a panic catcher was running and vice-versa.
+
+ To catch panics etc, use the following code:
+
+ SDebugInfo info;
+ TRequestStatus status;
+ RDebug::GetException(info,status);
+ User::WaitForRequest(status);
+
+ SDebugInfo is defined in E32SVR.H
+
+ You must kill the thread that paniced at some point using:
+
+ RDebug::KillThread(info.iThread);
+
+ or it will remain suspended forever. Do not use RDebug::Open
+ or you will prevent GDB from running at the same time.
+
+ If someone starts GDB while your request to GetException is pending,
+ GDB takes priority and you will not recieve any notifications of threads
+ panicing until GDB quits
+
+ Only one call to GetException can be active at any one time. It is
+ quite safe to call GetException while GDB is running, your request
+ will remain pending until the first app panics after GDB quits
+
+ To cancel a request to GetException, use RDebug::CancelGetException()
+
+ This feature has been buried by Jane's RUndertaker class which
+ should be used in preference ('cos she says it's better :-()
+ The ability to use GetException without calling RDebug::Open will
+ be removed in a later release.
+
+ 3) Altered D_GDB, the GDB stub, so that if you launch it without
+ passing a program to debug on the command line, it will wait
+ for a thread to panic/hit a breakpoint and then call
+ User::Notify(). You can then start up GDB on the PC and
+ connect to the Protea and start debugging the thread that
+ paniced/hit a breakpoint.
+
+ To put a hardcoded breakpoint into your code, use the line:
+
+ asm(".word 0xe7ffffff");
+
+ in your code. Run D_GDB without passing a command line, and
+ start your program. When the notify appears saying that
+ a program has hit a breakpoint, start up GDB on the remote
+ PC and start debugging...
+
+3) Jane
+ 1) Added KErrException. Threads which make illegal accesses etc. are
+ now panicked with this value.
+
+ 2) Added RThread::RaiseException(TExcType aType)
+ For the time being, this just panics a thread with category
+ "Exception Raised" and panic number = the exception number
+ TExceptionType is obsolete, and will be retired at the next thaw.
+
+ 3) Filled all user mode stacks with 0x29 to aid spy programs
+
+ 4) Implemented the thread death notifer service. The class is
+
+ class RUndertaker : public RHandleBase
+ {
+ public:
+ IMPORT_C TInt Create();
+ IMPORT_C TInt Logon(TRequestStatus& aStatus,TInt& aThreadHandle) const;
+ IMPORT_C TInt LogonCancel(TRequestStatus& aStatus) const;
+ };
+
+ To use the class, create an RUndertaker and logon to it like so
+
+ RUndertaker u;
+ u.Create();
+ TRequeststatus stat;
+ TInt handle;
+ u.Logon(stat, handle);
+ User::WaitForRequest(stat);
+
+ When a thread dies, the status word is completed, and the handle is that
+ of the dying thread. To look at why the thread died, for example, you might
+ do the following...
+
+ RThread r;
+ r.SetHandle(handle);
+ if (r.ExitReason()==0x666)
+ {
+ ...
+
+ As you now have a handle on the dying thread, it won't go away until
+ you close it.
+
+ r.Close();
+
+ Look at T_THREAD for examples.
+
+ NOTE: This service isn't guaranteed. If a thread dies while you are not
+ logged on to your RUndertaker, obviously you'll miss it - and there is a
+ window of opportunity after a thread has died & your status has completed
+ and before you get chance to deal with this and logon on again.
+
+ NOTE2: Matt will be implementing a more general form of this in his
+ RChangeNotifier class, which will complete to tell you that a thread
+ has died, but not tell you *which* thread.
+
+4) Matthew
+ Fixed bugs: HA-207 (%J in TTime::FormatL should abbreviate in 12hour
+ mode) and HA-215 (CActiveScheduler::Add should assert parameter).
+
+5) Graham
+ Partial implementation of a kernel millisecond timer which
+ now runs the buzzer. Do not be alarmed if buzzing sounds
+ different in this release.
+
+Version 0.01.069
+================
+(Made by Jane, September 26th 1996)
+
+1) Jane
+ 1) Clients causing an exception are now panicked KErrAbort.
+
+ 2) Possible fix for curtains bug. Any more reports of curtains
+ welcome (sort of.)
+ The bug was caused because of the change in behaviour such that
+ a client thread is still hanging around when the server processes
+ the disconnect. If the process creator had already closed its
+ process handle, then the process died immediately, but the client
+ thread was left. Then when the client thread eventually died, it
+ closed its chunks, which involved removing them from the (dead)
+ process's address space. BANG!
+
+ Now the chunk is removed from the process address space earlier on.
+
+
+2) SteveG
+ 1) Release 068 had a problem with the MARM custom DLLs,
+ which prevented the LEDs from flashing. Now OK.
+
+3) Graham
+ 1) When the kernel faulted, it used to continue to run and
+ possibly do all sorts of bad things.
+ For the time being, we just print a helpful message to
+ COMM1 and loop forever. (In the future we will reset.)
+
+
+Version 0.01.068
+================
+(Made by Jane, September 23rd 1996)
+
+NOTE - T_RDRV failed on certain bananas. We think that it is due
+to a problem with the hardware - the door open interrupt is not
+asserted for these fruit.
+
+1) Graham
+ 1) Removed nocallentrypoint declarations in MARM .OBY files
+ and added dll= appropriately.
+
+ 2) Fixed HA-219 which caused the digitiser to stop working
+ after the sound driver had been used.
+
+ 3) Added a system of cumulative inertia into the digitiser.
+ Consider a system where a physical movement of the pen
+ produces an actual Pen Move Event only if it has moved
+ more than 1 pixel. Call this an inertia of value 1. So,
+ if the digitiser has an inertia value of 3, then it only
+ produces Pen Move Events when a movement of greater than
+ 3 pixels in any direction has occured. The system I am
+ now experimenting with is one where the longer the pen
+ stays in one place, the greater inertia it acquires. So,
+ normally, with the pen moving all the time, no inertia
+ effects are apparent. But, when the pen comes to rest,
+ then the inertia begins to increase by one unit for every
+ 1/4s that it remains within its 'inert event horizon'. It
+ is currently set so that the maximum possible inertia
+ value is 5. Clearly, I can't tell if this is a valuable
+ system until some higher level apps start running with
+ this O/S. So, feedback on this subject is especially
+ welcome.
+
+ 4) Speculative fix for HA-217 ('Curtains').
+
+ 5) Exported Hal::DisableIrqsToLevel1() et al. from the kernel
+
+ 6) Reworked the kernel exception interface (TException,Exc).
+
+2) SimonB
+ 1) Removal of F32 code from the EWINC library
+
+ 1) Addition of a new TWINC directory with MAK files for building all the code in TBAS. (The CPP files
+ used are the ones in TBAS). The header files from TBAS have been copied into TWINC, but this could
+ be rectified by changing the #includes to reference "..\TBAS\..."
+
+ 1) Addition of bld and run cmd for building WINC libs, and test code. Also for running the test code.
+
+ 1) Changes to MNT additional verbs
+
+ winc build the libarries
+ wincall
+ wincdeb
+ wincrel
+ wincudeb
+ wincurel
+ btwinc build the test code
+ btwincall
+ btwincdeb
+ btwincrel
+ btwincudeb
+ btwincurel
+ rtwinc Run the test code
+ rtwincall
+ rtwincdeb
+ rtwincrel
+ rtwincudeb
+ trwincurel
+
+
+ 1) Changes to EWINC MAK files and build cmd file to get Unicode variants to build and work. May still
+ need some more changes - (the mak files were completely stuffed with release builds compiling debug
+ code). It may be worth recreating all mak files again froms scratch
+
+ 1) Changes to E32Initialise. With the file server in a separate Dll, the init code follows the WINS
+ init code method for the file server.
+
+3) Jane
+ 1) Added new RThread::Create which takes an open RLibrary, as discussed in EON defects -
+ IMPORT_C TInt Create(const TDesC &aName,TThreadFunction aFunction,TInt aStackSize,TAny* aPtr,RLibrary* aLibrary,RProcess* aProcess,RHeap* aHeap, TInt aHeapMinSize,TInt aHeapMaxSize,TOwnerType aType);
+ This function takes all possible parameters so that a thread with an open library
+ handle can be created in another process, sharing a heap etc. (If the RLibrary*, RProcess*, RHeap*
+ are not required, just pass in NULL as usual.)
+
+ The entrypoints of the library are called before the thread's entrypoint.
+
+ NOTE - obviously the thread cannot access the handle it has on the library, so the library
+ can only get its final close when the thread dies.
+
+ 2) Fixed a bug to do with stack chunk creation. Improved the naming scheme for chunks.
+
+ 3) Various E32 Proposals
+ - Processes unmarked by default
+ - Queues don't allow shallow copies
+ - CActive functions const
+ - RTest Console() accessor for iConsole
+
+ 4) Improved the kernel server protection method, which was becoming more unsafe
+ with the addition of each new way of shooting a client thread. (Now if the kernel
+ server shoots a client, it should always leave KErrKernelServerLeave, after
+ stashing a suitable error to shoot the client with in K::ClientErrorCode)
+
+ 5) Fixed a few situations where the kernel was shooting itself rather than the client.
+
+ 6) Pervasive change, such that the Owmer() of a CObject - used in forming the
+ name - is correct for thread-owned objects.
+ If a semaphore A is owned by thread B in process C its name is now C::B::A
+ If it was owned by process C directly it would be called C::A
+
+4) SteveG
+ 1) Implemented control of the LEDs on the racks and P1. It is now possible to get your
+ red alarm LED on your banana to flash, but it will flash green. Please note that this
+ is not an E32 software bug
+
+ 2) Changed all occurances of TheSuperPage().iTotalRamSize to TheSuperPage().iMaxFreeRam,
+ and added iTotalRamSize and iTotalRomSize to the SuperPage. iRamDriveSize is now
+ setup correctly, and these figures will be returned properly when using UserHal::MemoryInfo
+
+ 3) Added ESpecialKeyBase and ESpeicalKeyCount to E32KEYS.H. Any scancode in this range passed
+ to the keyboard translator will be passed through unaltered, and can be used for the
+ on-screen keys facility provided by the window server
+
+5) Morgan
+ 1) Added RLibrary::FileName()
+ 2) Corrected the key mappings for Func and Alt on the X86 build
+ 3) Extended Library and Process RAM loading to share ready loaded code chunks. RAM loaded
+ Libraries can use ROM code chunks but currently Processes cannot. Suitable code chunks
+ are identified by matching their checksums.
+
+5) Matthew
+ 1) Implemented %lx, %ld etc for formatting TInt64s. Added TLex::Val functions for TInt64s.
+ Removed TLex::Convert() and TLex::ConvertList().
+
+ 2) Given DThreads and DProcesses ids: essentially just a unique TUint. Threads and processes
+ can be now opened by their id.
+
+ 3) Changed Hal::RomVersion() so that it now returns version number from the rom header on
+ Epoc platforms.
+6) Pete
+ 1) Changes to support Asci12-Rev2. (Still works with Rev1 though).
+ 2) ATA Driver - Validation of partition entries in MBR now added.
+ 3) ATA Driver - CHS and LBA addressing now supported (this allows us to work with Hitachi CF
+ card).
+
+7) Rog
+ 1) Introduced a rack only bug into hardware handshaking for the Serial driver. To facilitate a
+ timely E32 release the serial drivers will be re-released with C32. If you don't need h/w
+ handshaking or can get by on WINS, these drivers are just fine.
+
+Version 0.01.067
+================
+(Made by Jal, September 7th 1996)
+
+1) Jane
+ 1) MMU fix to do with re-allocating linear space after RAM disk
+ has grown.
+
+ 2) More build and mnt fixes.
+
+ 3) Fixed HA-204, incorrect error given by in WINS library loading.
+
+ 4) Fixed HA-205, bug in RThread::Create
+
+ 5) Changed the Environment class, so that all environment variables are
+ stored and compared in UPPER CASE.
+
+ 6) Changed ks_proc as requested by Colly so that names which are duplicates except
+ for generation are allowed.
+
+ 7) Fixed HA-95, allowing the server to refer to the client thread when processing a
+ disconnect message
+
+ 8) Fixed HA-211, RProcess::Open stops process from being destroyed
+
+ 9) Fixed HA-210, runtime checks on queues
+
+ 10) Implemented basic exception handling - i.e. shooting the offending thread. Fixes
+ bugs HA-137 and HA-157
+
+ 11) Fixed HA-212, RLibrary::Load problems after creating thread in foreign process
+
+
+2) Matthew
+ 1) Bug fixes HA-188, HA-198 and HA-202. Also fixed a time-mangling bug on
+ the rack, which effected relative timers due to off after more than
+ about 30 seconds, and a bug which caused the sound LDD to panic.
+
+3) SteveG
+ 1) On the WINS build, F10 and F11 now send EKeySliderDown and
+ EKeySliderUp keypresses. F12 key is now the OFF key and
+ sends an EKeyOff keypress. The UserHal::SwitchOff() function
+ now minimizes the WINS window, simulating switching off.
+ Maximising the window will simulate switching on by sending
+ a TEvent::SwitchOn. The Shell, or whoever switches off,
+ should just look for EKeyOff and then call UserHal::SwitchOff
+ which will then work with the correct key on all platforms
+
+ 2) Implemented the TTime::Set(TDesC& aString) function which
+ allows setting or constructing a TTime from a date string
+ in the format YYYYMMDD:HHMMSS.MMMM - any part of the string
+ may be omitted, but either the dot or colon must be present.
+ Any parts of the string which are omitted are zero'd.
+
+ 3) Added suitable values to be returned by the WINS memory
+ functions in UserHal::MemoryInfo()
+
+ 4) Fixed problem with supplying long category names when
+ panicing a thread - only the first 16 characters used
+
+4) Morgan
+ 1) Fixed HA-191 by not passing the placement new as an argument to
+ CArrayFixBase::ResizeL.
+ Fixed HA-187. Under WINS Mutex are signaled in thread CleanUp code
+ rather than in the DPlatThread destructor.
+ Fixed a Bug in Time::FormatL to prevent the %C directive overflowing
+ the descriptor and causing a panic.
+
+ 2) CArray???::FindIsq returns an index of 0 if the array is empty.
+
+ 3) User::IsRomAddress is back. Again.
+
+
+Version 0.01.066
+================
+(Made by Jane, August 23rd 1996)
+
+1) SteveG
+ 1) Re-fixed bug in ARM Mem::Copy and Mem::Move, which got
+ lost prior to releasing 0.01.065. Refixed the test
+ software T_FUNC.CPP as well. The bug meant that
+ Mem::Copy and Mem::Move didn't return the correct
+ address if the source and target were the same
+
+ 2) Debugger fixed to take into account the changes in the
+ way threads start - the change meant the debugger no
+ longer set a breakpoint at the start of the thread
+ when starting a debug session
+
+2) Matthew
+ 1) Fixes to sound LDD and arm PDD.
+
+3) Jane
+ 1) Various build fixes, especially to WINC
+
+
+Version 0.01.065
+================
+(Made by Jane and Jal, 17th August 1996)
+
+IMPORTANT NOTE:
+
+To avoid delaying the chain below us, this version of E32 has been released with
+2 known bugs and one possible bug. They are as follows...
+
+
+1. Problems on ARM build when the RAM drive grows beyond 1 Meg in size. To avoid this
+ bug, this release of E32/F32 implements a maximum size of 1 Meg for the RAM drive.
+
+2. T_SOUND fails on the ARM platform.
+
+3. T_CPER (CPeriodic test) fails on EPOC platforms. However, I believe this is not a bug
+ - Graham fixed the timers but the test code is out of date.
+
+4. There are WINC test code problems which aren't worth delaying the release for.
+
+1) Graham
+ 1) Added microseconds to the system time. This required a
+ fix to TEiger::RtcTickCount() to counteract an Eiger
+ hardware anomoly - the SYSFLG 64ths do not roll over to
+ zero at the same time as the RTC rolls over its seconds.
+ It does this on the half-second instead. Enhanced T_TIMER
+ to test this roll-over effect.
+
+ 2) Changed the MUTATBLE errors in E32DEF.H
+
+ 3) Updated EMARM.REL to include the P1 variant device drivers
+
+ 4) Fixed warnings in T_BUF.CPP.
+
+ 5) Fixed intrnal TTickLink services to work with microseconds
+ instead of tenths. In order to help device-driver writers,
+ I have changed the name of the functions to
+ PeriodicInMicroSeconds and OneShotInMicroSeconds.
+
+ 6) IMPORTANT
+
+ I have changed the way in which the timing services in E32 work.
+ Although the changes mean that more of the underlying mechanism
+ is exposed, it is hoped that this policy will result in more
+ programmer-friendly services once the theory has been explained.
+
+ The theory:
+
+ The timing services are based upon the regular pulse that animates
+ the operating system. The time between pulses is called the tick
+ period and this will vary according to the platform being used.
+ The tick period for WINS, for instance, is 100000 uS, while for
+ MARM it is 15625 uS.
+
+ A new service has been introduced which enables the programmer
+ to determine the length of the tick period in microseconds:
+
+ TInt UserHal::TickPeriod(TTimeIntervalMicroSeconds32& aPeriod)
+
+ But, for the purposes of the subsequent discussion, I will call
+ this length of time T.
+
+ So, we have the following situation:
+
+ ---|-----------|-----------|-----------|-----------|--
+ <----------->
+ T
+
+ At any point in time, a program may request a timing service
+ such as User::After(x). This function should return x uS later.
+ Let us show this on the diagram and introduce the term y.
+
+ User::After(x)
+ |
+ ---|-----------|-----------|-----+-----|-----------|--
+ <-----------> <----->
+ T y
+
+ So, y represents the amount of time between the timing service
+ being requested and the next system tick. It is clear that y may
+ be any duration of time less than or equal to T.
+
+ Let's explore the behaviour of User::After(x) for a range of
+ different values of x.
+
+ x=0
+ ---
+ This will return on the next system tick. So, if you ask
+ for 0 uS, you actually get y uS.
+
+ User::After(0) Completes
+ | |
+ ---|-----------|-----------|-----+-----|-----------|--
+ <-----------> <----->
+ T y |
+
+ x<T
+ ---
+ This will also return on the next system tick. So, if you
+ ask for T-1 uS, you actually get y uS.
+
+ User::After(T-1) Completes
+ | |
+ ---|-----------|-----------|-----+-----|-----------|--
+ <-----------> <----->
+ T y |
+
+ x=T
+ ---
+ This will cause a wait of 1 tick to be set up. So, if you
+ ask for T uS, you actually get y+T uS.
+
+ User::After(T) Completes
+ | |
+ ---|-----------|-----------|-----+-----|-----------|--
+ <-----------> <----->
+ T y |
+
+ x=2T-1
+ ------
+ Just to expose the workings a little more. 2T-1 gets divided
+ by T to see how many ticks to wait. Any remainder is discarded.
+ Now, in integer maths, (2T-1)/T = 1. So, we set up a wait of
+ 1 tick. So, if you ask for 2T-1 uS, you actually get y+T uS.
+
+ User::After(2T-1) Completes
+ | |
+ ---|-----------|-----------|-----+-----|-----------|--
+ <-----------> <----->
+ T y |
+
+ x=2T
+ ----
+ 2T/T = 2. So, we set up a wait of 2 ticks. So, if you ask
+ for 2T uS, you actually get y+2T uS.
+
+ User::After(2T) Completes
+ | |
+ ---|-----------|-----------|-----+-----|-----------|-----------|--
+ <-----------> <----->
+ T y |
+
+
+ Notes
+ -----
+
+ a. It is a slightly irksome feature of this system that if you
+ ask for x uS, you may end up waiting less time than x, or you
+ might end up waiting more time than x. It all depends on
+ the value of the 'wobble factor', y.
+
+ As mentioned above, if you ask for T-1 uS, you actually
+ get y uS. Now y could be, in fact it will in all probability
+ be, significantly less than T-1. On the other hand, if you ask
+ for T uS, you get T+y uS, which means you will be waiting a
+ longer time than that requested.
+
+ It is impossible, then, for the operating system using this
+ system to guarantee that it will wait at least as long as the
+ period of time requested. If this is the sort of guarantee you
+ need, then you will have to arrange it yourself by
+ adding (T-1) to your request. You can determine T using the
+ UserHal function mentioned above.
+
+ b. In some situations the value of y is known. Consider a
+ periodic timer. After the first callback, you know that
+ you are now synchronised to the system tick and that y
+ is just less than T. The 'wobble factor', in this situation,
+ can be taken allowed for by the programmer. So, if you start
+ a CPeriodic with a delay of 0 uS and an interval of 0 uS,
+ you will get one which immediately starts calling back on
+ every system tick.
+
+ c. Timing test programs commonly want to synchronise to the
+ system tick in order to remove the 'wobble factor' from
+ their calculations. This can now be achieved using User::After(0).
+
+
+2) Jane
+ 1) Added new User class layout from Martin Tasker.
+
+ 2) Re-fixed WINS RDebug.Print (HA-170) which had become un-edited after
+ I put it in!
+
+ 3) Added CObjectIx::Count() to return the total number of
+ objects in a CObjectIx.
+
+ 4) Added RThread::HandleCount(TInt& aProcessHandleCount, TInt& aThreadHandleCount) const;
+ This returns the total number of handles open in a thread and
+ its owning process.
+
+ 5) Added RHandleBase::HandleInfo(THandleInfo* anInfo);
+ This function fills in a THandleInfo structure with
+ information about the current handle.
+
+ class THandleInfo
+ {
+ public:
+ TInt iNumOpenInProcess;
+ TInt iNumOpenInThread;
+ TInt iNumProcesses;
+ TInt iNumThreads;
+ };
+
+ iNumOpenInProcess = the number of times the object given by
+ the handle is open in this process.
+ iNumOpenInThread = the number of times the object given by
+ the handle is open in this thread.
+ iNumProcesses = the number of processes which have a handle on the object.
+ iNumThreads = the number of threads which have a handle on the object.
+
+ 6) Added an extra defaulted parameter to many RHandleBase derived classes' Create calls.
+ For example, from RMutex...
+ TInt CreateLocal(TOwnerType aType=EOwnerProcess);
+ TInt CreateGlobal(const TDesC &aName,TOwnerType aType=EOwnerProcess);
+
+ The owner type specifies whether the handle created is
+ thread or process relative. (The default is process-relative
+ as before.)
+ Process-relative handles may be passed between threads in
+ the same process without duplication. The handles are held
+ in the process, and are not closed when the thread dies, so
+ the objects will hang around until the process dies.
+ Thread-relative handles need to be duplicated between
+ threads in the same process, but the handles will be closed
+ when the thread dies.
+
+ IMPORTANT NOTE 1
+ Due to design considerations, RLibraries and RTimers are
+ now always thread relative handles. You will need to
+ duplicate them if they are shared between threads. RLibraries
+ should now unload when their access counts become 0.
+
+ Fixes bug HA-170
+
+ 7) Fixed X86 crash on test failure.
+
+ 8) Fixed HA-177 - panicking a dead thread kills the caller.
+
+ 9) Fixed HA-180 - panic enum was incorrect.
+
+ 10) Dll loading changes.
+
+ RLibrary load api becomes...
+ TInt Load(const TDesC &aFileName,const TDesC &aPath=_L(""));
+
+ If aFileName is a full filename with path, then aPath will be ignored,
+ and the only load attempted will be that of aFileName. If the dll is not
+ at the specified location, the load will fail.
+ If aFileName is just a rootname, (e.g. _L("ECONS.DLL")), then the dll
+ will be searched for in the following order - specifed path, followed by
+ the system directory on each attached drive.
+
+ IMPORTANT - old calls with the extension specified as the second parameter
+ e.g. lib.Load(_L("MYDLL"),_L(".DLL")) are now likely to fail as the second
+ parameter is now interpreted as a path.
+
+ 11) Dll entrypoints
+ For the first time under EPOC, DLL entrypoints are now called.
+
+ When a process is loaded, all the DLLs to which it is statically linked
+ get their entrypoints called with the value EDllThreadAttach. (This call
+ is on behalf of and in the context of the main thread.)
+ When a new thread is created in the process, the statically
+ linked DLLs' entrypoints are again called with EDllThreadAttach in the
+ context of the newly created thread.
+ When each thread in the process dies, the entrypoints are called with
+ EDllThreadDetach in the context of that thread.
+
+ Unlike Windows NT, I do not call entrypoints with EDllProcessAttach and
+ EDllProcessDetach. This is because the function pair Dll::GlobalAlloc()
+ and Dll::GlobalAllocated (currently unimplemented) allow the DLL to
+ discover its first ever call, if necessary. This is though to be more
+ useful in our system then knowing a first call per process. Similarly
+ Dll::SetTls() and Dll::Tls() enable the DLL to discover its first load
+ within a thread.
+
+ When a thread loads a DLL dynamically via RLibrary::Load(), the DLL's
+ entrypoint is called, if and only if this is the first load of this DLL
+ within the thread. (So if a process is statically linked to FRED.DLL and then
+ a thread does an RLibrary::Load of FRED.DLL, then FRED's entrypoint is not called
+ in response to this load.)
+ The entrypoint is called with the value EDllThreadAttach in the context of the
+ thread loading the DLL.
+
+ The above situation is further complicated by DLL's themselves being statically
+ linked to other DLLs. When a DLL is loaded, I make a list of unique DLL entrypoints
+ in the statically linked chain, and call each of them once only. So if DLL
+ A is linked to DLLs B, C and D, and then B is linked to X, C and Y, and D is
+ linked to B, C, and Z, then the entrypoints for A, B, C, D, X, Y and Z are called
+ once each when A is loaded.
+ If A were statically linked to just B and C, then when it was loaded just the
+ entrypoints for A, B, C, X, Y would be called. If the same thread then went
+ on to load D, then the entrypoints which had not already been loaded in that
+ thread would be called - i.e. D and Z.
+
+ All this DLL entrypoint calling can get very time-consuming in the case of
+ many of the DLLs in the ROM which have no need for entrypoints to be called.
+ In this case, add "nocallentrypoint" after the DLL's specification line in the
+ obeyfile, and no entrypoints will be called for that DLL or any DLLs below it
+ in the static linkage chain.
+ All drivers should have "nocallentrypoint" specifiers.
+
+ E.g. primary=\xxx\ekernd.exe sys\kernel.exe nocallentrypoint
+
+
+ IMPORTANT NOTE 2
+
+ Although for many of the files "nocallentrypoint" is optional, it is compulsory for
+ kernel.exe and efile.exe. Bad things happen if the kernel's entrypoint is called
+ when something which is linked to it is loaded, and the file server doesn't take
+ too kindly to it either!
+ Also, note that the name of efsrv.dll has changed in the obeyfile. It's probably
+ best to cut and paste from the released E32 obeyfiles.
+
+ There are new versions of ROMBUILD & PETRAN which support the above obeyfile
+ changes and new structures necessary for the calling of DLL entrypoints.
+
+ 12) Due to the new directory scheme, it has been possible to remove
+ RLibrary::LoadExact. RLibrary::Load now does a load exact - i.e. it does no
+ name mangling on the name passed in as a parameter.
+
+ RLoader::LoadExact has been renamed to RLoader::Load. This will affect you
+ if you have one of those "mini-loaders" for WINS which allows you to live
+ without the file server.
+
+
+3) SteveG
+ 1) Altered all builds of E32 to use the new directory structure \Epoc32\Build and
+ \Epoc32\Release
+
+ 2) Added SetModifierState function to KeyTranslator:
+
+ TInt SetModifierState(TEventModifier aModifier,TModifierState aState)
+
+ which alters the supplied modifier according to the supplied state.
+ TModifierState is defined in E32Keys.h and is one of ETurnOnModifier,
+ ETurnOffModifier or EToggleModifier.
+
+ 3) Fixed bug in KYTRAN where left and right modifiers were not being set
+
+ 4) Implimented DigitizerCalibration functions, and wrote simple text shell
+ calibration program. A calibrator will need to be written as an Eikon app.
+
+ A calibration program should:
+
+ Call UserHal::CalibrationPoints(TCalibration& aCalibration) which will return
+ three screen coordinates at which points should be plotted. The user should
+ touch these three points, and the values returned by the digitizer for the points
+ actually touched should then be returned to
+ UserHal::SetXYInputCalibration(TCalibration aCalibration)
+
+ Note that a TCalibration actually has 4 points - the 4th is ignored by
+ SetXYInputCalibration
+
+ Suitable default calibration values incorporated into each ARM variant, so
+ the calibration on your yellow jobbie should be more or less correct without
+ calibrating. If yours is wildly off, please let us know
+
+ 5) Added profiling support to all platforms, and increased the number of nested
+ profiles to 64. You can specify a range of profiles to clear/read results of.
+ Results returned in microseconds, but only recorded at tick resolution. This
+ avoids changing the API when profiles are measured more accurately.
+
+ Using profiles:
+
+ Decide on the profile numbers you are going to use, between 0 and 63. You can
+ use any of them, unless someone else is using some in the same ROM build.
+
+ Reset the profiles you are using, by:
+
+ RDebug::ProfileReset(aStart,aCount);
+
+ which resets aCount profiles starting from profile number aStart.
+
+ Surround the code with __PROFILE_START(n) and __PROFILE_END(n) where n is
+ a number of your choice between 0 and 63 inclusive. You can nest the profiles.
+
+ Return the results using:
+
+ TProfile profile[n]; // n is the number of results you are reading
+
+ RDebug::ProfileResults(&profile[0],aStart,aCount);
+
+ which writes the results of aCount profiles starting with profile number
+ aStart into your profile array.
+
+ TProfile is currently defined as:
+
+ class TProfile
+ {
+ TInt iTime;
+ TInt iCount;
+ };
+
+ You need to include E32SVR.H in your code to use profiles
+
+ 6) Moved the keystroke data dll to the variant level, allowing
+ different keyboard layouts for each implementation. Changed
+ the P1 version to give correct keystrokes and modifiers on the
+ yellow jobbies.
+
+ On the real Proteas:
+ Fn sets EModifierLeftFunc and EModifierFunc
+ Menu sets EModifierLeftAlt and EModifierAlt
+ Fn-Esc sends an EKeyOff keypress
+ Fn-M sends an EKeyDecContrast keypress
+ Fn-, sends an EKeyIncContrast keypress
+
+ On B and C racks:
+ Alt sets EModifierLeftAlt and EModifierAlt
+ Alt-Esc sends EKeyOff
+ Alt-, sends EKeyDecContrast
+ Alt-. sends EKeyIncContrast
+
+ On WINS:
+ Left Alt sets EModifierLeftAlt and EModifierAlt
+ Right Alt sets EModifierFunc and EModifierLeftCtrl
+ and EModiiferCtrl (the setting of Ctrl is a Windows
+ funny and can't be prevented AFAIK)
+
+
+ 7) Fixed bug with ARM coded Mem::Copy and Mem::Move where it
+ returned the wrong value if the source and targets were the same
+
+
+4) AdamG
+ 1) Much of ECOMM re-written to speed up data paths and fix all known serial driver
+ bugs.
+
+ 2) Implemented reference counting of interrupts in all serial PDDs for all hardware
+ and platform variants.
+
+ 3) Added use of NT Critical sections to WINS Serial PDD to eliminate multiple
+ completion bugs.
+
+ 4) Corrected signal polarity in all MARM serial PDDs.
+
+5) Matthew
+ 1) Changes to TLocale.
+ Most importantly there are now four date separators and four time separators, one
+ for the beginning, one for the end and two potentially different internal
+ separators. The convention is that the NULL character represents no separator.
+ This has had a knock on effect on the TTime::FormatL() function: now '%:0' means
+ first time separator, '%/3' means the forth date separator etc.
+
+ Additionally there is now an AmPmSymbolPosition indicator, and different distance
+ units for different contexts: one general and two for short/long distances.
+
+ 2) Added an RChangeNotifier class, for notifying users of global changes. At the
+ moment changes to TLocale and midnight crossover are the only things which are
+ notified.
+
+ To use call Create() and then Logon() with a TRequestStatus. This first Logon()
+ will complete straight away with the value EChangesAll. Subsequent logons will
+ complete next time there is a change and the status will contain a bitfield
+ indicating what has changed.
+
+ 3) Made certain TInt64 functions inline. Also changed the default constructor so
+ that it does not assign zero.
+
+ 4) Changed the X86 build so that getting the time returns fractions of seconds. The
+ time is now given to the nearest tick (which occur at just over 18.2Hz on the X86).
+
+ 5) Added unary minus operators to TPoint and TSize.
+
+ 6) Changes to sound driver: Fixed a bug that caused a crash when you tried cancelling
+ playing alarm sounds. Stopped it from panicking in Wins if you turned beeps off
+ from the control panel.
+
+6) Jal
+ 1) Various internal changes to TLocalDrive and media drivers.
+
+ 2) Added operator[] to CObjectIx
+
+7) Morgan
+ 1) More RThread test code under Suspend/Resume conditions
+ and fixes to WINS and EPOC threads.
+ 2) Moved User::IsRomAddress to the file server where it is now called
+ RFs::IsRomAddress
+ 3) Added User::TickPeriod
+ 4) Added physical screen size (in twips) to MachineInfo
+
+8) Steve & Jane
+
+ Implemented new Epoc32 directory structure (described in more detail on Notes.)
+
+ All makefiles should be changed so that the intermediate files are built to
+ e.g. \Epoc32\Build\WINS\E32\Deb for exes and \Epoc32\Build\WINSD\E32\Deb for dlls.
+ The executables and dlls themselves should be built to
+ e.g. \Epoc32\Release\WINS\Deb. (NOTE - there is no "E32" in this directory path -
+ all releasables for a given build go to the same directory.)
+
+ E32 mnt makework currently makes the whole Epoc32 structure - this can be used to
+ get started.
+
+ mnt gettools gets tools to Epoc32\Tools. This should be added to your path from
+ the control panel. All existing paths to \tools should be removed if possible
+ - if not possible then the e32 tools themselves should be removed from any tools
+ directories in your path.
+
+ \E32SYS should also be removed from the path.
+
+ The scheme whereby executables can be installed under Epoc32\WINS\Z and appear as
+ if they are under Z: is not in this release, but will be in the next one. For the
+ time being, the old scheme with romfile.bin holds.
+
+ NOTE: GCC only runs from C:\Epoc32\GCC\BIN, so if you are working on a substed
+ drive, you will still need an Epoc32 directory with GCC in on C:.
+
+
+Version 0.01.064
+================
+(Made by Graham, 26 July '96)
+
+1) Graham
+ 1) Integrated WINC into MNT.CMD. This version is the first
+ to include a release of WINC.
+
+ 2) Implemented a special version of RDebug::SupervisorMode
+ which suits the purposes of REPRO.EXE
+
+ 3) REPRO.EXE now works. It communicates with a program called
+ PREPRO.EXE which runs on the PC. You can get this program
+ from S: using GETREL PTOOL PEIGER 104 in your \TOOLS
+ directory. You may type PREPRO for command line options, but, in
+ general, you merely type PREPRO imagefilename.IMG. The PC will
+ then wait for the Protea to lead communications.
+
+ Now run the REPRO program on your Protea. Make sure you do
+ not remove mains power during the reprogramming process.
+
+ Progress will be reported on the screen of the PC.
+
+ If an error is detected during the reprogramming process,
+ then the program on the Protea will just restart - erasing
+ all the flash chips again and then programming them.
+
+ This means that if you interrupt the PC program, no
+ disaster will occur. If you decide you are programming the wrong
+ image in the middle of the process, then just escape from the PC
+ program, get the correct image on your PC and restart
+ PREPRO with this image. By the time you have done this,
+ the Protea will have timed out and will have decided to
+ restart.
+
+ 4) Added Gillian's bug fix for TTime::MonthsFrom() and
+ TDateTime::SetHour()
+
+ 5) Changed EWSRV.EXE so that it hunts for ESHELL.EXE on all
+ drives from A: to Z:
+
+ 6) Upgraded BOOTROM.BIN to the new E32TOOLS(36)
+
+
+2) SteveG
+ 1) Fixed bug in Des::AppendNumUC which converted the whole
+ descriptor to uppercase rather than just the appended number
+
+ 2) Added simple profiling for ARM builds, which counts the
+ number of times a function or section of code is executed
+ and the time taken in ticks. A later version will be
+ more accurate (using a 512kHz timer).
+
+ To use this, surround the section of code to be tested with:
+
+ __PROFILE_START(n)
+ and
+ __PROFILE_END(n)
+
+ where n is a number between 0 and 7 inclusive. You use upto
+ 8 profiles, which can be nested if necessary. You will need
+ to use the RDebug class to access the results as follows:
+
+ TInt E32Main()
+ {
+ RDebug debug;
+
+ debug.ProfileReset(); // Clear readings & reset counts
+
+ __PROFILE_START(0);
+ <test code>
+ __PROFILE_END(0);
+
+ SProfileInfo profile;
+
+ debug.ProfileResult(profile);
+ }
+
+ SProfileInfo and RDebug are defined in E32SVR.H.
+
+ SProfileInfo is defined as:
+
+ struct SProfileInfo
+ {
+ TInt iCount[8];
+ TUint iTimes[8];
+ }
+
+ RDebug::ProfileResults returns the counts and times
+ for all 8 profiles, even if you are only using 1 profile.
+
+ 3) ARM coded the following E32 routines which were dog slow,
+ and changed the relevent descriptor functions to use these
+ new functions rather than their own copying code
+
+ Mem::Copy
+ Mem::Move
+ Mem::Swap
+ Mem::Fill
+ Mem::Compare
+
+ TDes8::AppendNum
+ TDes8::AppendNumUC
+
+ and added ARM code for signed or unsigned integer divide
+ by 2,4,5,7,8,10 and 16, which will improve the modulo
+ function as well.
+
+ Speed improvements, TDes::AppendNum()
+
+ TDes8::AppendNum has been optimised for hex, decimal, octal
+ and binary conversions, and is improved for all other
+ conversions as well.
+
+ TDes::AppendNum(num,EHex) is now 614% faster
+ TDes::AppendNum(num,EDecimal) is now 611% faster
+ TDes::AppendNum(num,EOctal) is now 751% faster
+ TDes::AppendNum(num,EBinary) is now 1322% faster
+
+ The uppercase conversions will be the same speed as the
+ lowercase ones, but the %age increase will be greater due
+ to the fact that the string is worked out in uppercase rather
+ than converting the descriptor to uppercase after the conversion,
+ as was done in the CPP version.
+
+ Speed improvements, Mem functions
+
+ Mem::Fill is now 236% faster for word aligned buffers, and
+ around 400% faster for non word aligned buffers, which were
+ slow before
+
+ Mem::Swap is now 975% faster for buffers which have the same
+ word or non-word alignment and around 160% faster for buffers
+ which have different alignments to each other
+
+ Mem::Move and Mem::Copy are 330% faster for word aligned
+ buffers. For buffers with the same byte alignment, the speed
+ increase is around 600%. If the two buffers have different
+ alignments to each other, the increase is around 157%.
+ Mem::Move will be slightly faster than Mem::Copy as it knows
+ the buffers are aligned by definition of the function.
+
+ Mem::Compare: no figures yet, but descriptor compares are
+ around 220% faster, although this depends on what you're
+ comparing
+
+ Speed improvements, Integer division
+
+ No speed measurements on this, but for divide by 16,8,4,2
+ should be pretty big, and the divide by 10 seems to be around
+ 200% faster. Much hair missing after realising that the GCC
+ routine __umodsi3 in UP_GCC.CPP (which returns the remainder
+ of a division), doesn't actually 'destroy r3' as it states in
+ the cpp file, it returns the quotient in r3, which is relied
+ upon in divide routines which call __umodsi3.
+
+ 4) DeBugger. Drastic unimprovements to get a working version,
+ which is now what we have :-)) The debugger will now not
+ single step into EUSER or certain other DLLs, as this
+ causes problems on the ARM build. As the ARM processor
+ does not have any single step or trace mode, all single
+ stepping is done by looking at the next instruction to
+ be executed, working out where the PC will be if that
+ instruction is executed, and setting a breakpoint at that
+ address. Stepping into EUSER or certain other DLLs causes
+ certain death as any thread could hit that breakpoint
+ before the thread being stepped. Although code has been
+ written to silently step any thread over a breakpoint
+ it shouldn't stop at, serious problems occur if the
+ kernel hits the breakpoint while in supervisor mode or similar.
+
+ A document on how to use GDB is on R:\E32\DOCS\GDB.DOC.
+ Contact me on x625 if you are daring enough to try and use
+ the most excellent GDB software.
+
+ If you wish to use the debugger, you need to include
+ D_GDB.EXE in your ROM build. Please ensure this is AFTER
+ euser.dll in the ROM and BEFORE anything you debug.
+ The debugger will not single step into any part of the ROM
+ that is before D_GDB.EXE. This is a quick 'bodge' to get
+ around the problem mentioned above, and allows a quick
+ method of changing what you can and can't single step
+ into.
+
+3) Rog
+ 1) Added CAsyncOneShot and CAsyncCallBack. These two active object
+ derived classes are like a single use CIdle. They can also be used
+ to transfer a thread of control between two threads. Because of the
+ way they work both classes are added to the current active scheduler
+ when they are created.
+
+ 2) Added delta timer class. CDeltatimer is a resource efficient timer
+ based on a delta queue and a single RTimer. Requests are identified by
+ TTimerHandles which are returned from CDeltaTimer::Queue and may be
+ passed to CDeltaTimer::Remove.
+
+ 3) Added the fast timer driver to the source release. Due to beta
+ deadlines work on the fast timer has ceased.
+
+4) Matthew
+ 1) Various changes to the sound LDD and PDDs. The main change is that
+ buffering in now done entirely within the LDD.
+
+ 2) Renamed TTime::SetNow() to HomeTime(); TTime::SetUniversal() to
+ UniversalTime() and User::SetSystemTime() to SetHomeTime(). The
+ "system time" is now universal time ie GMT. Home time takes into
+ account any daylight saving and time zone.
+
+ 3) Changes to TLocale - added SpaceBeforeAmPm and changed the way
+ daylight saving is handled.
+
+ 4) Fixed bug in second queue which caused absolute timers to run twice
+ as fast as they should have done.
+
+ 5) Implemented RHeap::CompressAll().
+
+5) Jane
+ 1) Added changes from Steve Townsend to optimize region code.
+
+ 2) Added timer fixes to thread clean-up code
+
+ 3) Fixed the RDebug death under WINS, and implemented RDebug::Print using
+ OutputDebugString to the debug window.
+
+6) Pete 1) Pc card Controller now allows allocation of card memory chunks smaller
+ than page size.
+ 2) Various omissions to Pc Card Controller now attended to.
+ 3) Improvements to media change handling.
+ 4) Internal ram drive supports size changing.
+ 5) TLocalDrive::Format() now calls back during formatting.
+ 6) TLocalDrive::Caps() returns more than just size.
+
+7) Morgan 1) Thread and Process protection.
+ The kernel, file server, null thread, supervisor are now marked as
+ system threads/processes. They are also Protected.
+ Any attempt to Panic, Kill, Terminate, SetPriority on a protected thread
+ will shoot the caller.
+ A thread's status can be changed with:
+ RThread::SetProtected(TBool)
+ RThread::SetSystem(TBool)
+ RThread::SetNotifyIfDie(TBool) (was SetServer)
+ RThread::SetMark(TBool)
+ Similar functions exist for processes.
+ The Exec functions (Set)Mark, and (Set)Server have been replaced with
+ (Set)Flags functions for threads and processes to implement this.
+
+ T_PS.EXE displays thread and process status.
+
+ 2) AppendFormat and AppendFormatList changes.
+ Both can now take a TDes[8|16]Overflow handler which is called when the
+ formatting operation would write to the descriptor beyond its max length.
+ When this happens and no overflow handler is supplied, the default action
+ is to panic.
+
+ 3) TTime::Format has become TTime::FormatL
+
+ 4) Added CServer *CSession::Server() to return the session's server.
+ Added protected member TDblQueIter<CSession *> CServer::iSessionQ, an
+ itterator over the server's sessions.
+
+ 5) Name changes
+ TTimeIntervalShortMicroSeconds -> TTimeIntervalMicroSeconds32
+ AfterInMicroSeconds -> After
+ TStartup -> TMachineStartupType
+ and some Americanisations
+
+ 6) Defined __ARRAY_NO_PTRS__
+ and *_CAST operators
+ Changed __ASSERT_*(c,p) to use (... p ,0)
+
+ 8) Removed huffman encoding/decoding from TBuf
+
+ 9) Implemented User::IsRomAddress(TAny *)
+
+ 10) Added a checksum member to TRomHeader
+
+
+
+Version 0.01.063
+================
+(Made by Graham 3 July '96)
+
+1) SteveG
+ 1) Applied patches to the GCC tools and rebuilt them all, with lotsa
+ help from Nick Twyman. You now no longer need template instantiations,
+ and the code saving seems to be somewhere between a massive 8 and 13%,
+ although the exact figure will vary between projects. You will need
+ to remove all occurances of 'template class.....' from your .cpp files.
+
+ 2) Altered the whole of E32 to compile with the new tools, removing every
+ 'template class...' line from all the source files, altering all the
+ MAK files etc. The new compiler/linker are a lot more nit-picky, and
+ you will experience several warnings such as 'class xxx only defines
+ private constructors and has no friends' or 'taking address of temporary'.
+ Handcrafted ARM MAK files will need changing by hand, v033 of MAKTRAN will
+ take care of any changes for you. Any handmade ARM MAK files will need
+ changing as follows:
+
+ change all occurances of -m6 to -mcpu=arm710 -mapcs-32 and remove all
+ instances of -fno-implicit-templates. Add in -fvtable-thunks after the
+ -fcheck-new flag. To remove the warnings 'class xxxx only defines
+ private constructors and has no friends' add in the flag
+ -Wno-ctor-dtor-privacy after the -Wall flag.
+
+ If anyone has any problems with the new tools, please hesitate to
+ contact me on x625.
+
+ 3) Wrote various benchmark tests to identify areas of E32 that could
+ improve with being written in ARM code. Start made on testing speed
+ increases for various descriptor/memory/number functions in ARM code.
+
+ 4) Debugger (Arrrrrrrrrgh :-(
+ Source level debugging now possible to some extent running a debug
+ .exe file from the E32 text shell (if you can bear to use Gdb).
+ No success with an eikon app yet. Identified some problems caused
+ by single stepping through user functions which my breakpoint
+ handler uses (memcopy, array/descriptor functions etc). The first
+ thing my breakpoint handler does is to clear any breakpoints in
+ the ROM, but in doing so it cannot use any functions which might have
+ breakpoints set in them.
+
+2) Matthew
+ 1) Changed RThread::Read() and Write() so that they leave on errors.
+ This fixes HA-158 - CSession::WriteL(...) panics caller.
+
+ 2) Added RThread::SetInitialParameter() and RThread::GetHeap(),
+ fixing HA-63, so you can now create an RThread, find its heap,
+ alloc a cell in that heap, pass the pointer to that cell as the
+ parameter to the thread and the thread can call User::Free on it.
+
+ 3) Made KCurrentThreadHandle have the NoClose flag set, so that
+ Close()ing an RThread which hasn't been Create()ed is harmless.
+
+ 4) RThread and RProcess::LogonCancel() now return KErrGeneral if
+ you are not logged on.
+
+3) Graham
+ 1) Built and released Protea Rev 1 (P1) variant of MARM.
+
+ 2) Made WeekNoInYear and DayNoInYear const correct.
+
+ 3) Removed 'API Freeze Technology'
+
+ 4) Added the REPRO program which must be included (In PETRAN
+ format) in all P1 variant ROMs. NB this program does not
+ work yet.
+
+ 5) Re-included Andrew Theolke's fix for Single Queues. This
+ means that everyone will have to remove their work-arounds
+
+ 6) Fixed the HAL API problem with UserHal::BacklightBehaviour
+
+ 7) Reintroduced stack frames into the debug MARM builds of EKERN
+ and EUSER.
+
+4) Jane.
+ 1) Fixed linear address allocation problem with hardware chunks.
+
+ 2) Stopped a false read of CMOS data/time information under X86
+ killing the kernel.
+
+ 3) Fixed bug HA-150 - Rng was returning T rather than TBool
+
+ 4) Removed J Day hacks and old functionality for RAM loading
+ of exes and dlls, and added support for new E32Image format etc.
+
+ IMPORTANT NOTE - You must now update to the latest version of E32TOOLS. This
+ version of E32/F32 is incompatible with versions of tools pre 029.
+
+5) Morgan
+ 1) Added WINS Led simulation. To turn the Leds on and off use:
+ UserHal::ModifyLedMask(TUint aClearMask, TUint aSetMask);
+ with the masks, KLedMaskRed1 and KLedMaskGreen1
+
+ 2) Removed the protea bitmap from the kernels WINS resource.
+ The bitmap is now loaded from \E32\KPWINS\PROTEA.BMP at runtime.
+
+ 3) Implemented TSecondQ::SystemTimeChanged()
+
+ User::SetSystemTime() now completes all pending timers on the
+ K::SecondQ with KErrAbort.
+
+ 4) Added DTimer::Abort() to support this.
+
+
+Version 0.01.062
+================
+(Made by Graham, 31st May 1996)
+
+
+1) Graham Fixed MARM Debug mode
+
+2) Pete Added Media change handling. This allows CF cards to
+ be inserted or removed without the need to reset. All
+ that is now required is that the DOOR switch is
+ depressed during these operations.
+
+ NB Do not attempt to use the CF card (or even boot up
+ a rack with a CF card inserted) if your rack does not
+ have a special capacitor fitted to counteract a fault
+ in the ETNA chip (ASIC12)
+
+Version 0.01.061
+================
+(Made by Graham, 30th May 1996)
+
+1) Jane
+ 1. Implemented E32 Proposal: TDes8::Append(const TDesC16&)
+
+ 2. Implemented E32 Proposal: calling RMessage::Complete twice panics server not kernel
+
+ 3. Implemented E32 Proposal: priority enumeration for active objects
+
+ 4. Fixed bug HA-93: referring to a dead thread panics caller
+
+2) Matthew
+ Fixed bug HA-102: K::BeepComplete can be catastrophic
+
+3) Rog Added IrDA support to serial LDD and COM1 PDDs
+ Enabling Irda will automatically set framing and
+ handshaking to SIR standards (i.e. 8N1 None)
+
+ Added CheckConfig()=0 to PDDs this allows PDDS to
+ furtle with the default configuration before the
+ driver is created (in specific it allows the Etna
+ driver to disable the Fifo.)
+
+4) Pete Added ATA media driver for Compact Flash cards
+ (MEDATA.PDD). This allows read/write/format of CF cards
+ via TLocalDrive. However, media change interrupts aren't
+ handled yet. Therefore racks must be powered down or Reset
+ before inserting or removing a card to remove power
+ from the CF card socket.
+
+NB Use E32TOOLS(028) - this release contains a .EXE which exposes
+a bug in earlier versions of ROMBUILD. You should also use these
+tools because the new MAKTRAN causes -fcheck-new to be introduced
+into the gcc compiler options.
+
+Version 0.01.060
+================
+(Made by Graham, 23rd May 1996)
+
+1) Pete
+ 1. General enhancement to TLocalDrive and its corresponding
+ kernel side objects to support Media Drivers. TDriveBase/TPlatDrive
+ now replaced with TLocDrv which is platform independant.
+
+ 2. TLocalDrive::Connect() can now take a reference to a
+ media change flag (TBool).
+
+ 3. Internal Ram Drive now implemented using Media Driver.
+
+ 4. Further improvements to RPcCardController.
+
+2) Rog
+ 1. All but a complete re-write of serial LDD. Throughput much
+ increased.
+
+ 2. Support for COM1 on RackC is now available from the new
+ DATXPC1.PDD.
+
+ 3. Hardware handshaking is currently broken.
+
+3) Graham
+ 1. Etna support fixed.
+
+ 2. Removed redundant .FRZ files
+
+4) Jane
+ 1. Added support for RAM loading of dlls and exes. Currently entrypoints
+ are called in the same manner as for ROM exes and dlls, i.e. only once
+ for a process attach, and never for a thread attach/detach, or a process
+ detach.
+
+ IMPORTANT NOTE: To support this, the format of the rom headers has
+ changed, and there are new rom building tools - see E32TOOLs release notes.
+ The old tools are incompatible with E32 060.
+
+ 2. Added RDebug::Print(TRefByValue<const TDesC> aFmt,...) which outputs
+ text to COM1 from user side code as an aid in debugging.
+
+
+Version 0.01.059
+================
+(Made by Colly)
+
+1) Fixed RLibrary::LoadExact() which would not load more than 1
+ DLL at a time.
+
+Version 0.01.058
+=============[==
+(Made by Matthew)
+
+1) Colly
+ 1. Changed the _S8,_S16 and _S macros to return
+
+ const TText*
+
+ rather than
+
+ TText*
+
+ which was allowing writeable descriptors to be constructed illegally
+ over strings. i.e.
+
+ TPrtC(_S("Test string"));
+
+ Bad news as strings are in the text segment and read only.
+ Compiler will now refuse to compile the above code.
+
+ 2. Renamed class TGuid to TUid and changed the representation to just
+ a signed integer (to keep Bill happy). Added the class TUidC where
+ C stands for constructor which just has two constructor, a default
+ constructor which effectively sets the UID to KNullUid and one
+ taking an integer. Given a uid of 0x10000000 then TUidC(0x10000000)
+ will construct the right UID. KNullUid is unfortunately implemented
+ as a #define to avoid class consts.
+
+ Everywhere that guid was used has now been changed to uid which
+ effected RLibrary and the registry functions.
+
+ Renamed the uid test DLL from T_UID to T_DUID and the test program
+ from T_GUID to T_UID.
+
+ 3. Changed CObjectCon::FindByName() and CObjectCon::FindByFullName()
+ to use MatchF() instead of Match(). CObject::FullName() used to
+ concatenate Owner().Name() with Name(). It now concatenates
+ Owner().FullName() with Name().
+
+ 4. Changed TCreateProcessInfo and TCreateLibraryInfo to have a TUid
+ which in due course will be supplied by the loader from the
+ .exe and .dll headers. Added the TUid to DProcess and DLibrary.
+ Also added iGeneration to DProcess so that more than one process
+ can be run at the same time.
+
+ 5. Changed the name of a library to include the TUid::Name().
+ If library t_test.dll is loaded and it has a TUid of 0x10000001
+ then its name will be:
+
+ t_test[10000001]
+
+ 6. Changed the name of a Process() to include the TUid::Name()
+ followed by iGeneration as a 4 digit decimal value. If process
+ t_test.exe is loaded and it has a TUid of 0x10000001 and
+ it is the the third copy running its name will be:
+
+ t_test[10000001]0002
+
+ 7. Added Mem::Crc()
+
+ which performs the 16 bit CCITT checksum. It should be called
+ for a descriptor as follows:
+
+ TPtrC8 des=_L("Check string");
+ TUint16 crc=0;
+ Mem::Crc(crc,des.Ptr(),des.Length());
+
+ 8. Added the TUidType class. This class packages three UIDs
+ together. It is intended to provide Type, SubType and
+ SubSubType together for the typimng mechanism in E32. It
+ has the following important functions:
+
+ TUidType::IsValid()
+ TRUE if at least one of the UIDs is not KNullUid
+ TUidType::IsPresent(TUid aUid)
+ TRUE if any one of the UIDs == aUid
+ TUidType::MostDerived()
+ {
+ if (iUid[2]!=KNullUid)
+ return(iUid[2]);
+ if (iUid[1]!=KNullUid)
+ return(iUid[1]);
+ return(iUid[0]);
+ }
+
+ 9. Added the TCheckedUid class. This class packages a TUidType
+ together with a checksum. It is intended to be placed at the
+ beginning of all E32 binary files as follows:
+
+ TCheckedUid check(TUidType(0x10000001)); // Created the header
+ RFile f;
+ f.Open(theFs,_L("binary.file"),EFileWrite);
+ f.Write(check.Des()); // Write the descriptor
+ ....
+
+ The class can be reinstantiated from the binary file as follows
+
+ TPckgBuf<TCheckedUid> check;
+ RFile f;
+ f.Open(theFs,_L("binary.file"),EFileRead);
+ f.Read(check); // Read the signature
+ if (check().Type().IsValid()) // Is it a valid signature
+
+ 10.Added a new type TPassword which is just a 16 character buffer.
+
+ 11.Added the new abstract class CSecurityBase which provides
+ encryption/decryption functions given a TPassword. This is
+ polymorphic to allow other security systems to be
+ substituted at a later date. One implementation of a security
+ system is provided which implements a polyalphabetic
+ substitution which is similar to that on E32 but no great shakes.
+
+ In order to use CSecurityBase merely instantiate one with
+ Security::NewL(). By default the security object will be
+ initialsed with a zero length password and disabled. To
+ change its value use SetL(_L(""),new password). Alternatively
+ it can be re-initialised with a descriptor that was previously
+ extracted from a CSecurityBase with CSecurityBase::SecurityData().
+ The data returned by CSecurityBase::SecurityData() is intended to
+ be saved to file and acts as a token for the associated password.
+
+ Before encrypting or decrypting data use PrepareL() and there
+ after make continuous calls to EncryptL() or DecryptL().
+
+ Hopefully the other functions are self explanatory.
+
+ Added test code T_SEC.CPP to test the security system.
+
+ NOTE: Passwords are currently case sensitive.
+
+ 12.Added the machine password control functions
+
+ class Password
+ {
+ public:
+ IMPORT_C static TInt IsEnabled();
+ IMPORT_C static TInt SetEnable(const TPassword& aPassword,
+ TBool aIsEnabled);
+ IMPORT_C static TInt IsValid(const TPassword& aPassword);
+ IMPORT_C static TInt Set(const TPassword& anOldPassword,
+ const TPassword& aNewPassword);
+ };
+
+ Password::IsEnabled() returns the current state of the password
+ enabled flag. Password::SetEnabled() allows the state to be
+ changed but only if the correct password is supplied.
+
+ Password::IsValid() returns TRUE if the password is valid.
+
+ Password::Set() allows the password to be changed
+
+ By default the password is _L("")
+
+ 13.Added the notifier functions:
+
+ TInt User::Notify(const TDesC& aLine1,const TDesC& aLine2,
+ const TDesC& aBut1);
+ TInt User::Notify(const TDesC& aLine1,const TDesC& aLine2,
+ const TDesC& aBut1,const TDesC& aBut2);
+ TInt User::Notify(const TDesC& aLine1,const TDesC& aLine2,
+ const TDesC& aBut1,const TDesC& aBut2,
+ const TDesC& aBut3);
+
+ The function will attempt to connect to a server called
+ __NOTIFIER_NAME (#define in E32SVR.H) and then send a message
+ ENotifierNotify with P0() pointing to a TPckgBuf<TNotifyInfo>.
+ It is allowable for iButton[1] or iButton[2] to be NULL in which case
+ one, two or three button should occur in the dialog. If aBut1
+ is picked then 0 is returned, 1 for aBut2 and 2 for aBut3. Any
+ other error such as their being no Notifier or a result being
+ wrong will result in a return of KErrGeneral.
+ 14.Added Mem::Move() which has the same API as Mem::Copy(). Move()
+ assumes that src and trg are 2^2 aligned and that aLength is a
+ multiple of 4.
+ 15.Added a new time interval TTimeIntervalShortMicroSeconds
+ which is an interval in micro seconds but stored in a 32
+ integer. This is the new interval when specifying After()
+ delays. Note that I have left the low level kern services
+ in ticks for now.
+ 16.Renamed
+ RTimer::After() to RTimer::AfterInMicroSeconds()
+ CTimer::After() to CTimer::AfterInMicroSeconds()
+ User::After() to User::AfterInMicroSeconds()
+ CPeriodic::Start() to CPeriodic::StartInMicroSeconds()
+ to aid the conversion to the new interval. When converting
+ just multiply the value being passed originally by 100000
+ which is ofcourse the number of microseconds in a tenth of
+ a second.
+ 17).RSessionBase::CreateSession() and
+ RSessionBase::SetRetry() both take a
+ TTimeIntervalShortMicroSeconds as the the delay interval.
+ 18).Fixed mnt.cmd by adding %_F32VER% as the second parameter
+ of all recursive getXXX calls to fix defect HA-121 reported
+ by DavidW.
+ 19).Made the Timer services TicksToTenths() a bit easier to
+ implement and OneShot() timing slightly more accurate.
+
+2) Geert
+
+ 1. Removed CArrayFixBase::DestroyAll(). Use the new
+ CArrayPtr<T> class template instead. (See below.)
+
+ 2. Added support for objects that can only ever
+ live inside an array. E.g. support for a variable
+ array of TBufC<100000>, where the elements are just
+ big enough to contain the actual data in the
+ buffer.
+
+ CArrayFix<T>::ExpandL(TInt anIndex) opens up a slot
+ at anIndex by shifting the elements after anIndex
+ and returns a reference to the new element. The new
+ element is constructed in place.
+ ArrayFix<T>::ExtendL() is equivalent to ExpandL(Count()).
+ CArrayVar<T>::ExpandL(TInt anIndex,TInt aLength)
+ opens up a slot of size aLength at anIndex by and
+ is otherwise the same as the fixed record case.
+ CArrayVar<T>::ExtendL(TInt aLength) is equivalent
+ to ExpandL(Count(),aLength).
+
+ 3. Added repeated insertion and re-sizing functions
+ to CArrayFix.
+
+ CArrayFix<T>::InsertL(TInt anIndex,const T& aRef,TInt aReplicas)
+ inserts a copy of aRef, aReplicas times.
+ CArrayFix<T>::ResizeL(TInt aCount)
+ extends or shrinks the array as needed for it to
+ contain aCount elements. Any new elements are
+ bitwise copies of a default-constructed T.
+ CArrayFix<T>::ResizeL(TInt aCount,const T& aRef)
+ extends or shrinks the array like ResizeL(TInt).
+ New elements, however, are bitwise copies of aRef.
+
+ NB. As a result of these changes, the element type
+ has to have an accessible default constructor. If
+ you have a CArrayXxx<TYyy>, and some custom
+ TYyy::TYyy(TZzz aZzz) exists, a TYyy::TYyy() will
+ have to be added. A knock-on effect is that C-style
+ arrays can no longer be supported as element types.
+
+ Note that array elements are still bitwise copies,
+ and will be Mem::Copy()-ed around during their
+ lifetime. Having the constructor called merely
+ guarantees that they'll be bitwise copies of a
+ properly constructed object, rather than random
+ garbage. In keeping with this, array functions may
+ construct instances of the element types, but they
+ will never destroy them. Element types need not
+ have an accessible destructor.
+
+ 4. Changed CArrayXxx::InsertIsqL() and added the
+ new funcion InsertIsqAllowDuplicatesL()
+
+ CArrayFix<T>::InsertIsqL(const T& aRef,TKeyArrayFix &aKey)
+ and
+ CArrayFix<T>::InsertIsqAllowDuplicatesL(const T& aRef,TKeyArrayFix &aKey)
+ return the new element's index.
+ InsertIsqL() leaves with KErrAlreadyExists if a
+ duplicate is discovered, and
+ InsertIsqAllowDuplicatesL() inserts the element
+ after any duplicate. The existing InsertIsqL(),
+ returning KErrNone or KErrAlreadyExists, and taking
+ a TAllowDuplicates argument is withdrawn.
+ In the case of variable-element arrays, the
+ signatures are
+ CArrayVar<T>::InsertIsqL(const T& aRef,TInt aLength,TKeyArrayFix &aKey)
+ and
+ CArrayVar<T>::InsertIsqAllowDuplicatesL(const T& aRef,TInt aLength,TKeyArrayFix &aKey).
+
+ Note that the meaning of InsertIsqL()'s return
+ value has changed and care should be taken when
+ porting.
+
+ 5. Almost all the array manipulation functions in
+ CArrayXxxBase have become public. This is to allow
+ code to operate on incoming (typed) arrays in a
+ type-independent way. It can be argued this reduces
+ type-safety and encapsulation, but the most
+ important thing is to guard against accidental
+ misuse. This is done by providing typed functions
+ in the template classes overriding--and hiding--all
+ the unsafe functions.
+
+ 6. Added functions CArrayXxx<T>::At(TInt anIndex).
+ They are synonymous with CArrayXxx<T>::operator[]()
+ and serve to hide the At() functions in the base
+ classes.
+
+ 7. Added CArrayFix<TAny>, CArrayFixFlat<TAny> and
+ CArrayFixSeg<TAny> as well as CArrayVar<TAny> and
+ CArrayPak<TAny>. They are hand-crafted and somewhat
+ restricted instances of the templates, for those
+ who wish to use a generic array; e.g., as a member
+ of the base class in a template pair. In the case
+ of CArrayFixXxx<TAny>, the record length is
+ specified as a constructor parameter.
+
+ 8. Added functions CArrayXxx::AppendL(), Find(),
+ FindIsq() and InsertL() taking a reference to T
+ instead of a pointer. People wishing to switch to
+ the reference-based API may define the macro
+ __ARRAY_NO_PTRS__, which will hide the
+ pointer-based versions.
+
+ 9. Added class template CArrayPtr<T> extending
+ CArrayFix<T*>'s interface with a ResetAndDestroy()
+ function. The function is intended as a type safe
+ replacement for CArrayFix<CBase*>::DestroyAll().
+ It is equivalent to a loop delete-ing all (pointer)
+ elements, followed by Reset().
+
+ 10. CBufBase::ExpandL(TInt aPos,TInt aLength) makes
+ room for aLength bytes at aPos. The new contents
+ are undefined. InsertL(Pos,aPtr,aLength) is
+ equivalent to ExpandL(aPos,aLength) followed by
+ Write(aPos,aPtr,aLength).
+
+ 11. CBufBase::ResizeL(TInt aSize) expands or
+ deletes from the buffer at the end so that its
+ Size() becomes equal to aSize. Not to be confused
+ with CBufFlat::SetReserveL, which has no effect on
+ the logical size of the buffer.
+
+ 12. CBufFlat::Capacity() reports the size the
+ buffer can grow to without reallocation. The buffer
+ insertion functions are guaranteed not to leave
+ until the buffers Size() reaches or exceeds its
+ Capacity(). A flat buffer's capacity is changed
+ using SetReserveL().
+
+ 13. Removed the global new operator taking a base
+ pointer and check size; ie., TAny* operator
+ new(TUint aSize,TAny* aBase,TInt aCheckSize)
+
+ Making sure at runtime that the allocated size is
+ he same as the supplied buffer size is not a very
+ common requirement. As it turned out, size checking
+ was really only required for RHeap and derived
+ classes. Supplying it with a custom RHeap::operator
+ new(), as is now the case, is actually a cheaper
+ solution.
+
+ 14. Added zero-filling versions of the full set of
+ available global new operators to CBase and removed
+ CBase's delete operator.
+
+ The delete operator was there only as a workaround
+ for a problem with the Visual C++ linker. The
+ problem appears to be fixed in Visual C++ 4.0, so
+ there is now no point in having the operator.
+
+ 15. Added pragma's disabling Visual C++ warnings to
+ do with the generation of copy constructors and
+ assignment operators to <e32def.h>.
+
+ 16. Added private, undefined copy constructors and
+ assignment operators to CBase. Copying and
+ assignment of CBase-derived classes is now
+ prohibited by default.
+
+3). Graham
+ 1. Various keyboard changes.
+
+ 2. Added HAL set and sense functions. Most are not
+ yet implemented but will be in 059.
+
+4). Steve
+ 1. Debugger:
+ Further improvement and additions to the debugger classes and the Gdb stub.
+ Still no bug fixes back form Cygnus to allow source level debugging using
+ Gdb. Added support for multiple thread debugging, and allowing breakpoints
+ to be set in ROM which effect the threads you specify rather than all
+ threads. Finalised the API for the RDebug class which is used by any
+ debugger or debug stump program. Full details of the E32 debugger class
+ currently in R:\E32\DOCS\RDEBUG.DOC.
+
+ 2. Key translator:
+ Fixed the bug where the modifier status wasn't updated on a modifier key
+ down - it was updated on the next key up or down.
+
+5). Jane
+ 1. Removed saving and restoring of fs & gs in interrupt code to speed up
+ X86 version of EPOC.
+
+ 2.Added support for debugger in finding code address of target processes.
+ Added MMU functions to support debugger in shadowing ROM. (Both untested).
+
+ 3.Added process cleanup code to fix process logon - but left it commented
+ out due to time pressure in meeting API freeze. Will be tested and in
+ place in 059.
+
+ 4.Added start of code supporting process and dll loading from RAM, and
+ added dummy APIs for future additions to this. Rationalised kernel
+ LoadLibrary functions.
+
+ 5.Fixed stack scribble in runThread, which was causing an incorrect
+ return status to be given to logging threads.
+
+6). Roger
+ Serial LDD reliability improved. Fixed double completion bugs.
+
+ Eiger Serial PDD. Turned interrupts off during initial fifo priming.
+
+ Etna Serial PDD. Written not able to test due to a (suspected) kernel bug.
+
+ Further changes to the serial drivers as of Sat 4th May given
+ to Colly.
+
+7). Matthew
+ Preliminary sound Ldd and Pdds for Wins and Eiger. Currently the Wins PDD
+ pretends to play by making random beeps for the appropriate length of time
+ and pretends to record aLaw data by filling a bufer with silence in the
+ appropriate time. The Eiger PDD just plays silence.
+
+8). Pete
+ Improvements to Pc Card Controller and its user interface.
+
+ Simulation of Media Change using F5 key added to WINS (commented out for
+ now).
+
+Version 0.01.057
+================
+(Made by Graham, Friday 19th April)
+
+1) Graham
+ 1. Implemented MNT ARMALL, ARM, ARMDEB, ARMREL, ARMUDEB, ARMUREL
+ BTSTARMALL, BTSTARM, BTSTARMDEB, BTSTARMREL, BTSTARMUDEB,
+ BTSTARMUREL.
+
+ 2. Fixed bugs in BMARM\XDUMM.MAK, XKEYB.MAK, and XXYIN.MAK
+
+ 3. Fixed F32\BMARM\ESHELL.MAK to vary name according to
+ build - ESHELL.EXE, ESHELLD.EXE, ESHELLU.EXE, ESHELLUD.EXE
+
+ 4. Updated ARM Rom building system to build debug and unicode
+ roms as well.
+
+ 5. Ensured O/S and test programs build in DEBUG and UNICODE
+ as well as RELEASE mode.
+
+ 6. Removed redundant LCD contrast handling from
+ VARMPR\VA_KEYB.CPP
+
+ 7. Added KE_ETNA.CPP with the help of Roger and Peter.
+
+ 8. Rationalised variant system, allowing for three MARM
+ variants. Each variant for a given architecture has a
+ two character mnemomnic:
+
+ PB Protea rack B
+ PC Protea rack C
+ P1 Protea version 1
+
+ Each variant has an E32\ sub-directory:
+
+ \E32\VARMPB
+ \E32\VARMPC
+ \E32\VARMP1
+
+ Each must contain a VA_CUST.CPP which implements class
+ Custom and produces an ECUST.DLL which the kernel links to.
+ These ECUST.DLL's are called CARMPB.DLL, CARMPC.DLL, and
+ CARMP1.DLL until one of them is selected to become
+ ECUST.DLL in the ROM.
+
+ They must also include keyboard or pointer device
+ implementations (VA_KEYB.CPP and VA_XYIN.CPP) which
+ create CAKYPB.DLL, CAKYPC.DLL, CAKYP1.DLL (Arm keyboard
+ DLL's) and CAXYPB.DLL, CAXYPC.DLL, CAXYP1.DLL (Arm XY
+ input device DLL's).
+
+ Normally, they will also include a VA_HW.CPP which
+ implements variant-specific hardware functionality. These go
+ on to produce the variant dll's VARMPB.DLL, VARMPC.DLL,
+ and VARMP1.DLL. Physical Device drivers (which are intrinsically
+ Variant-level entities) and custom dll's might want to
+ link to these DLL's, but the kernel cannot.
+
+ They will also contain PDD source.
+
+ The upshot of this is that .OBY files have to change.
+
+ A typical Protea Rack B .OBY file will begin:
+
+ romname=arompb.img
+ version=0.01
+ bootbinary=c:\work\emarm\bootrom.bin
+ romsize=0x400000
+ romlinearbase=0x50000000
+ romalign=0x1000
+ kerneldataaddress=0x80100000
+ kernelstackaddress=0x80000000
+ kernelheapmin=0x10000
+ dataaddress=0x400000
+
+ files=
+ primary=c:\work\emarm\ekern.exe sys\ekern.exe
+ file=c:\work\emarm\euser.dll sys\euser.dll
+ file=c:\work\emarm\elocl.dll sys\elocl.dll
+ secondary=c:\work\emarm\efile.exe sys\efile.exe
+ file=c:\work\emarm\efsrv.dll sys\efsrv.dll
+ file=c:\work\emarm\elocal.fsy sys\elocal.fsy
+ file=c:\work\emarm\ewsrv.exe sys\ewsrv.exe
+ file=c:\work\emarm\econs.dll sys\econs.dll
+ file=c:\work\emarm\edisp.dll sys\edisp.dll
+ file=c:\work\emarm\varmpb.dll sys\varmpb.dll
+ file=c:\work\emarm\carmpb.dll sys\ecust.dll
+ file=c:\work\emarm\cakypb.dll sys\ekeyb.dll
+ file=c:\work\emarm\caxypb.dll sys\exyin.dll
+ file=c:\work\emarm\ektran.dll sys\ektran.dll
+ file=c:\work\emarm\ekdata.dll sys\ekdata.dll
+ file=c:\work\emarm\eshell.exe sys\eshell.exe
+
+ A typical Protea Rack C .OBY file will begin:
+
+ romname=arompc.img
+ version=0.01
+ bootbinary=c:\work\emarm\bootrom.bin
+ romsize=0x400000
+ romlinearbase=0x50000000
+ romalign=0x1000
+ kerneldataaddress=0x80100000
+ kernelstackaddress=0x80000000
+ kernelheapmin=0x10000
+ dataaddress=0x400000
+
+ files=
+ primary=c:\work\emarm\ekern.exe sys\ekern.exe
+ file=c:\work\emarm\euser.dll sys\euser.dll
+ file=c:\work\emarm\elocl.dll sys\elocl.dll
+ secondary=c:\work\emarm\efile.exe sys\efile.exe
+ file=c:\work\emarm\efsrv.dll sys\efsrv.dll
+ file=c:\work\emarm\elocal.fsy sys\elocal.fsy
+ file=c:\work\emarm\ewsrv.exe sys\ewsrv.exe
+ file=c:\work\emarm\econs.dll sys\econs.dll
+ file=c:\work\emarm\edisp.dll sys\edisp.dll
+ file=c:\work\emarm\varmpc.dll sys\varmpc.dll
+ file=c:\work\emarm\carmpc.dll sys\ecust.dll
+ file=c:\work\emarm\cakypc.dll sys\ekeyb.dll
+ file=c:\work\emarm\caxypc.dll sys\exyin.dll
+ file=c:\work\emarm\ektran.dll sys\ektran.dll
+ file=c:\work\emarm\ekdata.dll sys\ekdata.dll
+ file=c:\work\emarm\eshell.exe sys\eshell.exe
+
+ 9. Enhanced the KBARM\ rom building system to allow for the
+ production of all three variant ROMs.
+
+ 10. Fixed spurious Pen Up events on the digitiser.
+
+ 11. Added GETSRC verb to MNT.CMD
+
+2) Morgan
+ 1. Completed DEVICE/DRIVER name changes to LDD/PDD.
+
+ 2. Added operator++() to TTimerLockSpec
+
+ 3. Added TTimerLockSpec User::LockPeriod(). This returns which
+ of the TTimerLockSpec periods the clock is currently in.
+
+3) Jane
+ 1. Fixed some problems with the new chunk sheme, notably to do with
+ closing EPOC chunks.
+
+ 2. Added a new debug only build of the .def files for X86.
+
+ 3. Added MMU support for both kernel growth (contigous in linear and
+ high physical memory) and RAM drive growth (contigous in linear
+ and low physical memory) - moving other people's pages and page
+ tables out of the way if necessary. Added TMMU test code to test
+ these situations.
+
+ 4. Added a new function to the bit map allocator
+ AllocFromTopFrom(TInt aPos) which returns the
+ next free page after the one specified. Tidied
+ up AllocFromTop() a bit while I was at it.
+
+4) Colly
+ 1. Added User::PageSize() to return the current machine page size.
+
+ 2. Renamed RHeap::Destroy() to RHeap::Close().
+
+ 3. Implemented heap sharing for heaps in chunks by having it heaps
+ own and use an RCriticalSection as well as supporting access counting.
+ The function TInt RHeap::Open() should be used to open a heap for
+ sharing which increases the access count. A subsequent RHeap::Close()
+ will decrement the access count but the heap will only be discarded
+ if the access count goes to zero. The static function User::ChunkHeap
+ includes the call to Open(). Fixed address heaps cannot be shared and
+ calls to Open() will be panicked.
+
+ The heaps which are created when a thread is created and which can be
+ retrieved with a call to User::Heap() should not be closed with a call
+ to Close() since the chunk in which the heap is created contains the
+ threads stack as well as the heap. If Close() is called the thread will
+ be panicked. The constanst RHeap::EChunkStack for the heaps type indicate
+ this kind of a heap, while RHeap::EChunkNormal indicate a heap created
+ with User::ChunkHeap(). Type EChunkSupervisor will never be seen
+ by an user mode code.
+
+ A thread is usually created with its own heap, but it can also be
+ created to use either the current thread's heap or a heap already
+ created. To use the current threads heap:
+
+ RThread t;
+ TInt r=t.Create(_L("Shared1"),threadEntryPoint,KDefaultStackSize,
+ NULL,NULL);
+
+ The first of the TWO NULLs will cause the routine to share the
+ current threads heap. i.e. that returned by User::Heap().
+
+ To use a heap already created:
+
+ RHeap* pH=User::ChunkHeap(_L("Share"),User::PageSize(),0x100000);
+ test(pH!=NULL);
+ RThread t;
+ TInt r=t.Create(_L("Shared1"),threadEntryPoint,KDefaultStackSize,
+ pH,NULL);
+
+ NOTE: In either case above the Heap will be opened and closed
+ internally so you need not provide any cleanup. If you no longer
+ wish to retain your copy of the heap in the example above after the
+ new thread has been created then you can call pH->Close().
+
+ Finally note that if thread1 creates thread2 to share its heap and
+ then exits thread1's chunk will remain in existence until such time
+ as thread2 exits. This is so since thread2's heap is now in thread1's
+ chunk. Such are the joys of sharing heaps.
+
+ 4. Full automated heap growth is now implemented as is RHeap::Compress().
+ If the adjust to the heaps chunk fails the the kernel server will be
+ called to attempt to compress all heaps known to the kernel. When
+ completed a further attempt will be made to adjust the chunk so that
+ the heap can grow. Remember that a heap will never be compressed
+ below its minimum size and that heaps can onlybe compressed if they
+ have free space at the top of the heap.
+
+ 5. Added a default argument TOwnerType aType=EOwnerProcess to most
+ of the operating system types CreateLocal(),CreateGlobal() and
+ Open() functions. Because of the default paramter this change is
+ seamless all current programs. The meaning of TOwnerType is to
+ indicate whether the resulting RObject is owned by the Process or
+ the Thread. Owned by the Process has been the only behaviour allowed
+ until this change. EOwnerThread will make the thread the owner of the
+ handle. The effect of being owner by the thread is that when the
+ thread dies any handles owned by the thread and not closed, will be
+ closed automatically. Example of process ownership:
+
+ RLibrary lib;
+ test(lib.Load(_L("TESTDLL"));
+ //
+ // The library handle will be closed when the process exits
+ //
+ User::Exit(KErrNone);
+
+ Example of thread ownership
+
+ RLibrary lib;
+ test(lib.Load(_L("TESTDLL"),EOwnerThread);
+ //
+ // The library handle will be closed when the thread exits
+ //
+ User::Exit(KErrNone);
+
+ NB. Although the addition of TOwnerType arguments to the
+ appropriate function calls has been made, EOwnerThread-type
+ services have not yet been implemented. This change merely
+ prepares the way for such an implementation.
+
+ 6. Implemented the full and correct naming strategy for
+ objects in the base.
+
+ 7. The test DLLs T_START1.DLL, T_START2.DLL and T_START3.DLL were
+ all using a WIN32 function GetTickCount() to delay their startup
+ which was preventing them from being used as a test under Epoc/32.
+ Changed to use User::TickCount() and removed Kernel32.lib from
+ the link dependencies.
+
+5) Gillian
+
+ 1. Added TDateTime::SetYear() etc functions (Brendan's
+ accepted proposal E32.51 TDateTime setting functions)
+
+ 2. Added TTime::- and TTime-= functions for all TTimeInterval classes
+ (Richard Knights accepted proposal TTime should define operators -
+ and -=)
+
+ 3. Extended TTime::DateTime() function to deal with BC dates
+
+ 4. Added tests for all the above and tidied the test code up a
+ little.
+
+6) Roger
+ 1. Implemented DFcs under WINS. This allows us to use DFCs
+ from the serial LDD rather than the non WINs PDD. This gives
+ much more reliability under WINs and improved throughput under
+ MX86 and MARM.
+
+7) Steve
+ Key Translator:
+ 1) Added new modifier EModifierPureKey, which is set when a
+ ctrl-key combination does not alter the keycode (basically
+ any key other than Space,A-Z which return 0 to 26 respectively)
+
+ 2) Fixed bug so that ctrl-space returns a NULL key press
+ rather than being thrown away
+
+ 3) TPattern enums moved into E32SVR.H for use by wserv
+
+ Debugger:
+ 4) Removed the Gdb stub from the E32 kernel
+
+ 5) Added Debug and RDebug classes. Debug is on the Kernel side
+ and provides debugging functions for RDebug on the user side.
+ A user mode debugger or stub opens a channel to RDebug and
+ can then debug one or more threads. The RDebug class provides
+ functions for Single-stepping, setting breakpoints,
+ reading/writing memory and reading/setting of register
+ values. Watching of memory addresses will be provided
+ in a later release
+
+ 6) Added 'TInt iDataSize' into DPlatProcess for use by the Debug
+ class for returning the Bss address of a Process
+
+ 7) Simple program written to run on the rack which waits for
+ any thread to panic and then displays what has panicked
+ and why
+
+ 8) Gdb stub written which communicates between RDebug and Gdb
+ running on a remote host PC. Currently the Gdb stub only copes with
+ debugging one thread at a time, and due to problems with Gdb itself,
+ only limited debugging facilities are available.
+
+8) Pete
+ 1. Added PC Card Controller to WINS and MARM.
+
+9) NOTE to shared chunk users (FBSERV etc). Support for read-only
+ shared chunks has been withdrawn. Although the API remains, all
+ shared chunk users should ONLY open for read/write.
+
+
+Version 0.01.056
+================
+(Made by Morgan, Sometime soon)
+
+1) Matthew
+ Bug fixes:
+ HA-81: In Wins if a E32Dll returns an error this is now correctly
+ detected.
+ HA-58: (Just in time debugging added for Kernel Panics) fixed in
+ KSRC\KS_UTL.CPP
+ HA-62: (Flat buffers not compressed when cleared) fixed in
+ UBAS\UB_BUF.CPP.
+ HA-82 (ReadCancel() doesn't complete TRequestStatus) fixed in
+ WSRC\WS_WIN.CPP, tested in T_WSIMP.CPP.
+ HA-73, HA-74, HA-61, HA-52,58,61,62,69,73,74,81,82.
+
+2) Rog
+ Added:
+ IMPORT_C void CActive::SetPriority(TInt aPriority);
+ inline TInt CActive::Priority();
+ SetPriority() will panic if the AO is active when it is called.
+
+3) SteveT
+ 1: Added:
+ TBool TRegion::Contains(const TPoint &aPoint);
+ Simply returns True if the point is contained within the region,
+ False if not.
+
+ 2. Added a new template class RRegionBuf<N>
+ This is a cross between the two existing variants of the TRegion
+ class, it's black box spec is identical to the RRegion class, you
+ can have unlimited size regions but have to check for errors, but
+ a buffer big enough to hold <N> rectangles is included with the
+ RRegionBuf structure, this is used until it is full up when a
+ cell will be allocated and the whole rectangle list copied into
+ the allocated cell, the region will not revert back to using the
+ buffer even if it shrinks small enough fit.
+
+ These regions are chiefly designed to be used as temporary work
+ space on the stack where they will save a lot of calls to alloc
+ for trivial rectangle lists. Using these for long term region
+ storage would be inefficient as when the buffer overflows it is
+ left lying around empty wasting memory.
+
+ 3. After calling Close() the region can safely be reused, before
+ it was left in a dangerous state with a pointer to the old freed
+ cell.
+
+4) Jane
+ Changed EPOC to the new process relative chunk strategy. Under
+ this scheme, the process now owns a chunk, which contains the
+ .data and .bss (zero-filled data) sections. Each additional
+ thread now only has one chunk minimally, which contains its stack
+ and heap. This scheme saves on resources, and will allow the
+ process to live on if the main thread dies, a change I intend to
+ make later on.
+
+ Added support for shared chunks in EPOC. A global chunk - one
+ created with RChunk::CreateGlobal() - can be shared by other
+ processes/threads if they do an OpenGlobal() of the same chunk,
+ by name.
+
+ WARNING! The latter change has necessitated api changes in
+ RChunk, detailed below.
+
+ 1. The Create functions have gained an extra parameter, as shown.
+
+ IMPORT_C TInt CreateLocal(TInt aSize,TInt aMaxSize);
+ IMPORT_C TInt CreateGlobal(const TDesC &aName,TInt aSize,TInt
+ aMaxSize);
+
+ The new parameter, aSize, is the number of bytes to initially
+ commit to the chunk. IT IS NO LONGER NECESSARY TO ADJUST A NEW
+ CHUNK - it will be adjusted to aSize on creation.
+
+ 2. OpenGlobal has gained an extra parameter, as shown below.
+
+ IMPORT_C TInt OpenGlobal(const TDesC &aName,TBool isReadOnly);
+
+ The new parameter, isReadOnly, specifies whether the sharing
+ process wants readonly access to the chunk. Thus it is now
+ possible for the creator of a chunk to have read/write access to
+ it, but for others who share that chunk to be denied that
+ priviledge.
+
+ 3. As mentioned, it is now unnecessary to adjust a newly created
+ chunk. It will be adjusted to aSize bytes on creation.
+
+5) Colly
+ 1. Added Registry and Environment services
+
+6) Graham
+ 1. All release mode tests run on MARM
+
+ 2. Enhanced the MARM build to include DEBUG and UNICODE modes.
+
+ 3. Enhanced the Eiger Text Display Deiver to switch between
+ 1bpp, 2bpp, and 4bpp modes.
+
+ 4. Text Window server allows CTRL-ALT-1, CTRL-ALT-2,
+ CTRL-ALT4 to switch display modes. The rack now boots up
+ in 2bpp.mode.
+
+ 5. Released BOOTROM.BIN. It boots the rack in 2bpp mode, so
+ the same .BIN file may be used for Text Window Server and
+ Graphics Window Server ROM's.
+
+ 6. Added -fno-implicit-templates to the MARM builds and
+ removed -fvtable-thunks.
+
+7) Peter
+ 1. Added proto-ramdrive.
+
+
+Version 0.01.055
+================
+(Made by Morgan, 18 March '96)
+
+1). NickT,
+ TLex??. I have added two new classes TLexMark8 and TLexMark16 and
+ the obvious typedef TLexMark. These classes are used to record or
+ mark a positon in a TLex, hence
+ TLex8::Mark(TLexMark8& aMark)
+ which can be followed by, e.g.
+ TLex8::UnGetToMark(TLexMark8& aMark).
+ By and large, wherever there was a TLex?? member function which
+ used the internal mark, e.g. SkipSpaceAndMark, there is a new
+ member which is passed a TLexMark?? or reference to one.
+ I have retained the internal mark iMark, changing it to a
+ TLexMark, and all the existing member function remain, usually as
+ an inline function which passes the internal mark to the general
+ member function.
+ The TLex??::Val() members no longer use the internal mark to
+ recover from errors but use an automatic TLexMark?? constructed
+ within the function.
+
+ T???Que(Base). I have added a member function Reset() to the Sgl,
+ DBl and Delta ques which just resets the que to be empty (the
+ offset remains unchanged).
+
+ CArrayFix(Base)/CArrayVar(Base). I have added new member function
+ which over load the existing InsertIsqL members. The change is an
+ addition TInt& argument.
+ On returning from InsertIsqL, this is set to contain the position
+ within the array of either the new entry or, if the entry exists
+ and ENoDuplicates is passed, the position of the pre-existing
+ entry.
+
+2). Morgan,
+ Plat::TickCount on WINS fixed so 1 tick = 1/10th of a second.
+ CBufxxx::New is now CBufxxx::NewL. The CArray classes have been
+ altered to use these.
+ CActiveScheduler made concrete and constructor made public.
+
+ Removed PopAndDestroyAll from TCleanupTrapHandler::Untrap which
+ now calls CCleanup::PreviousLevel(). This ASSERTS that the
+ cleanup stack's current level is empty. All Pushes to the clean
+ up stack must be balanced with a Pop before the Trap unwinds
+ naturally. +Test code.
+
+ Added PushL() and Pop() member functions to TAutoClose so they
+ can be pushed onto the cleanup stack and are closed automatically
+ on a leave. +Test code.
+
+ Added TReal and TReal96 formating to TDes?::Format
+ New specifiers are:
+ %f(%F) - format TReal(TReal96) (was padding)
+ %e(%E) - format TReal(TReal96) using exponent format
+ %g(%G) - format TReal(TReal96) using general format
+ %p(%P) - padding (used to be %f)
+ and
+ .n - specify n decimal places
+
+ New thread test code, to test Suspend/Resume while the thread is
+ suspended on a semaphore.
+
+ Extended RTimer/CTimer with locked timers for synchronisation to
+ fractions of a second.
+
+ Included USERTYPE.DAT in the release.
+
+3). Jane,
+ Fixed Exc::Dispatch which was deferencing NULL in certain cases.
+ Fixed DLogonProcess derivation, which was incorrect under the new
+ single phase destruct.
+ Added kernel protection for bad handles in both kernel server and
+ executive. Now the user thread should get panicked for a bad
+ handle, rather than the kernel dying when dereferencing 0. Now
+ that this is in place, I would welcome reports of any remaining
+ kernel death due to bad parameters, so that we may tighten up any
+ remaining loopholes.
+
+ Fixed CObjectIx::At which was panicking rather than returning 0 in
+ certain circumstances.
+ Added CObjectIx::AtL which leaves on a bad handle.
+
+ Added low memory handling to the MMU, and enhanced test code to
+ test that there are no alloc heavens in low memory situations.
+ Note that the rem page allocator function FreeHomePage() now takes
+ a physical address as a parameter rather than a linear one.
+
+ Added a new type of executive service, EXECUTIVE_SLOW_CONFORMANT
+ (int 22h on x86), which allows certain carefully chosen kernel
+ services to go re-entrant (i.e. be called from another slow kernel
+ executive service). Match8 and Match16 have been changed to this
+ new type, so that Match can be called from Exec::ThreadNext and
+ friends, thus allowing find services to work on EPOC.
+
+4). Matthew,
+ Tiny change to T_CHUNK (x86): now assumes the executable is T_CHUNK
+ rather than TCHUNK, and the case used on the command-line is not
+ important.
+
+5). SteveG
+ Key translation:
+ ================
+ Combined the keyboard translator files into two source files,
+ KY_TRAN.CPP and KY_CAPT.CPP.
+ These make up EKTRAN.DLL, which carries out translating the
+ scancodes into keycodes and modifiers and handles capture keys.
+ KD_MC400.CPP makes up the keyboard translator data dll
+ (EKDATA.DLL). Removed all .data from this DLL by copious use of
+ const.
+
+ Fixed the keytranslator so that modifier keys are returned as
+ EKeyNull.
+
+ CCaptureKey and CKeyTranslator are now defined in e32svr.h for use
+ by the Window Server. w32keyb.h and w32keyb.inl no longer exist.
+ In order to use the keyboard translator, theWindow Server must at
+ startup create a new CKeyTranslator, eg:
+ CKeyTranslator* KeyTranslator=CKeyTranslator::New();
+
+ The translate key function is defined as:
+ KeyTranslator->TranslateKey(TUint aScanCode, TBool aKeyUp, const
+ CCaptureKeys& aCaptureKeys, TKeyData& aKeyData)
+ and an extra function for obtaining the current modifier state
+ has been added:
+ TUint KeyTranslator->GetModifierState();
+
+ Key Modifiers
+ =============
+ EModifier enums are now defined in e32virt.h and are at the top
+ level. Anyone making use of 'TEvent::EModifierXxxxx' should
+ globally replace 'TEvent::EModifier' to 'EModifier'.
+ Removed the TModifier class. A normal TUint should be used in
+ place of TModifier, and anyone using the modifier functions
+ IsOn(), IsOff(), TurnOn() etc should do this using | and & etc.
+
+ E32 TEvents
+ ===========
+ Changed the E32 TEvent structure, and renamed it TRawEvent. A
+ TRawEvent is passed to the Window Server, which will create a
+ TWservEvent as before. TRawEvent is defined in e32svr.h and no
+ longer includes the modifier state. The modifier state is added in
+ in the Window Server for events that require the modifer state,
+ rather than being worked out and passed around for every event
+ type.
+ Changed the event types. Mouse events have been removed and
+ replaced with EPointerMove and EButtonNDown/Up events. The new
+ event types, defined in e32svr.h are:
+ enum TType
+ {
+ ENone,
+ EPointerMove,
+ EKeyDown,EKeyUp,
+ ERedraw,
+ ESwitchOn,
+ EInactive,
+ EButton1Down,EButton1Up,
+ EButton2Down,EButton2Up,
+ EButton3Down,EButton3Up
+ };
+
+ Changed all occurences of TEvent and TEventBuf to TRawEvent and
+ TRawEventBuf respectively in the E32 source and header files.
+ Changed Event.Set() and RawEvent copy constructors etc so they no
+ longer use the shiftState.
+
+6). Colly,
+ Changes required to implement the proposal to give DLLs a globally
+ unique identifier (GUID) which can be checked before trying to
+ call any of the functions in the DLL. It adds two functions to
+ RLibrary as well as adding the concrete data type TGuid. Included
+ is a test program T_GUID along with a test DLL T_UID, all of which
+ live in TBAS. I have also fixed bugs in the .MAK files for EKTRAN
+ and EKDATA.
+
+ A new version of t_romg.cpp which was broken by changes to
+ TDes?::Format() (i.e. changing %f to %p for padding).
+
+7). Jal,
+ Added methods to CSession:
+ IMPORT_C void ResourceCountMarkStart();
+ Panics client if CountResources returns KErrGeneral
+ IMPORT_C void ResourceCountMarkEnd();
+ Panics client if CountResources != iResourceCountMark
+ IMPORT_C virtual TInt CountResources();
+ Default implementation returns KErrGeneral
+
+
+Version 0.01.054
+================
+(Made by Morgan, 23 Feb '96)
+
+1). Colly
+ Removed two phase destruction. Note that all objects derived from
+ CActive must call Cancel() in their destructors. Note that
+ Adt::Destroy() has disappeared (replace with delete).
+ The class TAggregate depended on Adt::Destroy(), so it has
+ also disappeared (I don't think anyone was using it anyway).
+
+ Renamed E32ADT.H to E32BASE.H and the project UADT and TADT to
+ UBAS and TBAS. Decided not to include E32BASE.H in E32STD.H as
+ anyone can include E32BASE.H directly and achieve the same effect.
+
+ Removed all TBuf_10, TBuf_20 etc variants.
+
+2). Jane
+ Added an extra flag to TModifier: EModifierDoubleClick=0x00800000
+
+ Fixed DLogons which were writing back the wrong status into the
+ logged thread. The net effect being that now when you try to run a
+ program which doesn't exist, you don't crash the OS.
+
+ Added the window server to the dll startup scheme so that the font
+ server can be started before it. Look at wsrc\ws_utl.cpp to see
+ E32's window server startup code.
+
+ Added thread relative handles for DServer, DSession and client
+ DThread in server DThread. This was necessary for proper cleanup
+ of sessions when server and client threads died. It has the
+ side-effect of making the WINS implementation much more like the
+ EPOC one - and will show up any bugs where sessions are used from
+ another thread.
+
+ Added the Window Server to the dll startup scheme so that the font
+ server can be started before it.
+
+ Fixed bug in CObjectIx::Destruct(), HA-19.
+
+3). Matthew
+ Changed the base to use the new CServer/CSession with ServiceL in
+ CSession insted of CServer. The new versions of CSession and
+ CServer are now what used to be called CNewSession and CNewServer.
+ The windows server and test code use this new scheme.
+ If you have your own server/session then to convert you must
+ replace your CServer::ServiceL(RMessage&,CSession&) with a
+ CSession::ServiceL(RMessage&). In addition, if you have supplied
+ a CSession::CreateL() it should now be a
+ CSession::CreateL(CServer&).
+
+ Made TSglQueLink::Enque() private and TSglQueBase a friend of
+ TSglQueLink. Removed calls to Enque in T_SQUE.
+
+ Fixed X86 chunk routines. Additionally, changed WINS so that if
+ you try to create a chunk of negative/zero size it returns
+ KErrArgument instead of KErrGeneral.
+
+4). SteveG
+ This change affects the Window Server:
+ Changed TKeyTranslator::TranslateKey(). It no longer accepts a
+ TModifier as the second parameter. This function now takes care of
+ working out and storing the current key modifier states.
+ Now implemented as:
+ TBoot TKeyTranslator::TranslateKey(TUint aScanCode, TBool aKeyUp,
+ const CCaptureKeys& aCaptureKeys, SKeyData& aKeyData);
+
+ Altered \wsrc\ws_main.cpp and \wsrc\keytran.h accordingly, and
+ altered keytran.cpp to work out the key modifier states from the
+ supplied scancodes.
+ The keycode translator is now part of E32 as two DLL's: EKDATA.DLL
+ and EKTRAN.DLL.
+
+ Added the stub for the Gdb debugger. This adds two classes, Gdb
+ and ImpGdb. Class Gdb handles the communication protocol to the
+ remote PC running the debugger. The ImpGdb class handles all the
+ implementation specific functions such as returning register
+ values, setting breakpoints and the sending and receiving of data
+ packets to the remote PC.
+
+ Altered \e32\kex86\ke_int.cpp to pass control to the Gdb stub when
+ a breakpoint or single step trap occurs, and \e32\kearm\ke_int.cpp
+ to pass control to the Gdb stub when an undefined instruction is
+ executed.
+
+5). Morgan
+ Fixed thread cleanup code to cancel the threads timer if it had
+ not completed when the thread died. Previously the destructor was
+ attempting to close it after the thread's heap had been removed.
+
+ Made TInt64A::Cmp into a signed compare.
+ Fixed the DivMod function and other small fixes to get TInt64 code
+ running on the rack.
+ TInt64 operator >> now does an ASR. TInt64::Asr() has become
+ TInt64::Lsr()
+
+ Alloc fail tool changes:
+ __xHEAP_FAILNEXT(n) now fails once on the nth mem alloc.
+ CTimer::Create has become CTimer::ConstructL.
+ CActiveScheduler is now concrete.
+
+6). Graham
+ Incorporated ARM E32 - find GCC porting guide in 'Protea Software Design'.
+ Modified test programs so that they build under gcc.
+ Added digitiser code (XYIN) and general ADC control code.
+ Added compiler support functions for software floating point.
+ Added 'float' conversion routines to UM_R96.CPP
+ Removed data from ELOCL.DLL by appropriate use of const in LSRC\*.CPP
+
+ **** WARNING TO SERVER WRITERS ****
+
+ CSession::CreateL(CServer& aServer) has changed to
+ CSession::CreateL(const CServer& aServer)
+
+ This is a virtual function. If you supply your own version of this
+ function, then be sure to change its prototype. If you don't then you won't
+ get a compiler warning, but your program won't work any more.
+
+
+Version 0.01.053
+================
+(Made by Morgan, 29 Jan '96)
+
+1). Matthew
+ Removed all trace of the old date\time classes.
+
+ \E32\TCDT\T_FIND, which tests the find handles.
+ There's also a modified version of \E32\TCDT\T_KERN.CPP, which has had it's
+ brief TFindXxxx tests expanded to include the ones it previously missed out.
+
+2). SteveT
+ I'm just putting keyboard repeats into the window server. I've put this change
+ into \E32\KPWINS\KP_GUI.CPP to block windows auto repeats from getting
+ through.
+
+ line 169:
+ case WM_SYSKEYDOWN:
+ case WM_KEYDOWN:
+ if (!(HIWORD(lParam)&KF_REPEAT))
+ {
+ v.Set(TEvent::EKeyDown,PP::Sca....
+ Kern::AddEvent(v);
+ }
+ break;
+
+ Another change to KP_GUI.CPP to get the keyboard repeats going properly. This
+ adds a new TEvent type EInActive that informs me when the E32 window has lost
+ focus, the change I've done is as below.
+
+ case WM_ACTIVATE: // line 207
+ if ((lParam&0xFFFF)==WA_INACTIVE)
+ {
+ v.Set(TEvent::EInActive);
+ Kern::AddEvent(v);
+ }
+ break;
+ case WM_CHAR:
+
+ I'm not sure if this the best solution, presumably for completeness there
+ should be an EActive event as well, or add a true/false parameter to the event
+ to say whether it's an active or inactive message.
+ Of course on the real machine these events will never be used but I don't see
+ that as a problem.
+
+3). Morgan
+ Serial drivers for X86 and Eiger platforms.
+ TLinearSectionRam::CreateRegion now rounds the committed size argument to page
+ size before calling Map.
+
+4). Natascha
+ Character set conversion.
+ New test code (t_chset, t_chset2, t_chcon) for Unicode build
+
+5). Jane
+ Added User::SetDebugMask to allow the setting of the trace mask around
+ important sections of code.
+
+ Fixed various DSession closing and CServer bugs, including HA-51. EPOCX86 can
+ now run a test program more than once!!
+
+ Fixed a process creation bug.
+
+
+Version 0.01.052
+================
+(Made by Matthew, 16 Jan '96)
+
+1). Matthew
+ Modified the kernel to use the new date/time classes internally. This includes
+ the addition of new overloaded functions duplicating old ones. This should not
+ effect the external interface except in a few cases, where some functions have
+ been renamed XxxOld().
+
+ In release 053 the old functions will be removed and some data members will be
+ changed to the new date/time classes.
+
+2). Natascha
+ Character set conversion.
+
+ Replaced \e32\lsrc\LS_850.CPP with new file \e32\lsrc\LS_LAT1.CPP, which has
+ the same format:
+
+ type table for characters
+ and conversions for upper case, lower case, folding and collating.
+
+ for the Windows ISO Latin 1 character set.
+
+ There are 3 test programs:
+
+ 1) \e32\tlocale\t_chset.mak which writes to a file "chtest.txt" the descriptions
+ for the characters 32 - 255 together with a description of the character it is
+ mapped to for each of the upper case, lower case, folding and collating conversions.
+ It does this by reading from the tables in LS_LAT1.CPP directly. This is designed
+ to test the mapping tables in LS_LAT1.CPP.
+
+ 2) \e32\tlocale\t_chset2.mak which produces the same output to a file "chtest2.txt"
+ and console, but uses the functions provided by the TChar class instead of reading
+ the tables directly. This is designed to test that the changes made in
+ \e32\bwins\elocl.mak have taken effect. Note there is no collate output since
+ TChar has no collate function.
+
+ 3) \e32\tlocale\t_chcon.mak which produces a console output displaying the
+ attributes of a range of characters 0xC0-0xCF using functions in TChar. This
+ tests that the type table in LS_LAT1.CPP is correct.
+
+ All 3 test programs read from the text file e32\tlocale\winiso.txt.
+
+ Note that currently these new tests do not compile in unicode build.
+
+3). Matthew
+ Replaced TBool TRegion::Check() with TBool TRegion::IsContainedBy(), which
+ has the opposite sense, ie it returns ETrue when Check() returned EFalse and
+ vice-versa.
+
+4). Roger
+ Added write(0) functionality to the serial LDD.
+
+ A request to Write(...) with either a zero length descriptor or an explicit
+ zero length will not complete until the control lines are asserted in such a
+ way that a further write would actually send characters on to the line. The
+ exact behaviour of write(0) depends upon the iHandshaking field in the current
+ config.
+
+ eg.
+ void WaitForCTS(RComm& aSerial)
+ //
+ // Synchronously wait for CTS to be asserted, assumes aSerial is Open.
+ //
+ {
+ TCommConfig cBuf;
+ TCommConfigV01& c=cBuf();
+ aSerial.Config(cBuf);
+ c.iHandshake=KConfigObeyCTS;
+ TRequestStatus stat;
+ aSerial.Write(stat,TPtr8(NULL,0),0);
+ User::WaitForRequest(stat);
+ }
+
+ The XOn/XOff bits of iHandshaking are ignored for Write(0).
+
+ There are no changes to the PDD.
+
+5). Jane
+ Wrote display dll, video device (LDD) and VGA driver (PDD) for EPOCx86.
+
+ Fixed ImpHal::DisableInt() which was only pushing 16 bits of flags.
+
+ KMaxSectionBase in m32std.h was wrong - fixed.
+
+ Added TExec which tests number of exec calls in one second.
+
+6). Graham
+ Fixed allocation of run addresses to chunks in DPlatProcess::
+ AllocateDataSectionBase().
+
+7). Roger
+ Implemented CNewServer and CNewSession to run alongside CServer and CSession as
+ proposed in MartinT's E32 proposal "ServiceL() should belong to CSession, not
+ CServer". See E32 proposals for the API.
+
+ This code is not part of a fully accepted proposal as yet - the code is included
+ in the release to A) make further testing with the socket server less painful
+ and B) allow others to migrate servers to the new scheme if they wish.
+
+ Assuming the proposal becomes accepted, CServer and CSession will be replaced
+ with CNewServer and CNewSession.
+
+8). Matthew
+ Maths bug fixes and test code.
+
+
+Version 0.01.051
+================
+(Made by Matthew, 21 Dec '95)
+
+1). Jane
+ Implemented dll and device loading for EPOC platforms.
+
+ IMPORTANT NOTE
+ We have decided that when the entrypoint of a dll (E32Dll) succeeds, it should
+ return KErrNone rather than TRUE. Under WINS, the true entrypoint (_E32Dll)
+ converts KErrNone to TRUE before returning, but under EPOC this is not
+ necessary and we get tighter code by being able just to pass on the return
+ value of E32Dll().
+ So in release 051 all dll entrypoints must now return KErrNone if successful.
+
+ Added functions TBool User::JustInTime() and User::SetJustInTime(TBool) to
+ allow getting/setting a kernel variable which controls whether the debugger
+ macro executes its int 3 to do just in time debugging of panics with Visual
+ C++. The default is ETrue, i.e. just in time debugging is enabled.
+ All test code which traps deliberate panics should set this variable to
+ false around the code in question, to prevent Visual C++ firing up. See
+ TADT\T_CTIMER.CPP
+
+2). Morgan
+ Changes to TReal96: Changed KMatissaBits back to 53.
+ Added Normalise and Prepare functions.
+ GetTReal is now a const function.
+
+3). Gillian
+ Changes to the date and time classes
+
+ The following is a summary of the new classes, but see the report in E32 proposals
+ (Replacement for the existing date and time classes), and the ensuing discussion
+ for a fuller description of the classes and the motivation for these changes.
+
+ To avoid a name clash, the existing TDateTime class has been renamed TOldDateTime.
+ This along with TSystemTime, SDaySec, SDate and STime and the static date and time
+ functions in Userwill be withdrawn in release 053.
+
+ The functionality previously in TDateTime is provided by TTime which holds the
+ number of microseconds since midnight on 1st January 0AD in a TInt64. A TTime
+ object may be constructed from a TInt64, a TDateTime (see below) or a string
+ literal. Default construction will set the time 0.00am 1st January 2000AD. This
+ class also supports comparisons between TTimes, the addition of TTimeIntervals
+ (see below) to TTimes and the subtraction of TTimes (giving a TTimeInterval as the
+ result). Such arithmetic operations are allowed to over- or underflow, but an error
+ is returned if the results of a subtraction are too large to fit in the relevent
+ (32-bit) TTimeInterval.
+
+ The class TTimeIntervalMicroSeconds represents a 64-bit signed difference and the
+ classes TTimeIntervalSeconds, ...Minutes, ...Hours, ...Days, ...Months, ...Years
+ all derived from TTimeIntervalBase represent the differences in the rest of the
+ time bases in a 32-bit signed integer. These classes only support getting, setting
+ and comparison functions.
+
+ The new class TDateTime has been defined for easy user access to TTime. It has
+ year, month, day, hour, minute, second and microsecond data members, all held as
+ TInts and therefore replaces the SDate and STime structs. This can hold times longer
+ than TTime but no checks will be made on construction or assignment. The TDateTime
+ class will only support getting and setting functions.
+
+ The static functions date and time functions previously in User are now in the class
+ Time.
+
+ Omissions - BC dates, string parsing.
+ Proviso - Due to bug in TInt64 class Time::MaxTTime() and MinTTime() fail comparisons
+
+4). Colly
+ Removed RThread::Read() and Write() variants taking 2 parameters.
+
+ Provided RMessage::ReadL and WriteL functions. These call the appropriate Client
+ functions, so the code like
+ myMessage.Client().Read(...)
+ should now be changed to
+ myMessage.ReadL(...)
+
+ Removed AllocHeaps.
+
+ Added preliminary code for support of shared heaps. In functions where a heap was
+ previously created using given min and max heap sizes there is now an extra argument:
+ RHeap * aHeap. If this is NULL then everything proceeds as before. Otherwise, the
+ given heap is used. However, this is not properly implemented as yet and so for now
+ you should always pass a null pointer.
+
+ Replaced the constructor RHeap(THeapType aType,TInt aMinLength,TInt aMaxLength,TInt
+ aGrowBy) with RHeap(TInt aMaxLength).
+
+5). Matthew
+ If TCallBack::iFunction==NULL then TCallBack::CallBack() returns 0. The default
+ constructor now sets iFunction=NULL.
+
+ CBufBase::DoInsertL() has been made private and a new overloaded variant of InsertL
+ has been added.
+
+ Added CActiveScheduler::Level(), which returns iLevel.
+
+6). New error codes:
+ const TInt KErrTimedOut=(-33);
+ const TInt KErrCouldNotConnect=(-34);
+ const TInt KErrCouldNotDisconnect=(-35);
+ const TInt KErrSubSystem=(-36);
+ const TInt KErrBadLibraryEntryPoint=(-37);
+ const TInt KErrBadDescriptor=(-38);
+
+
+Version 0.01.050
+================
+(Made by Matthew, 12 Dec '95)
+
+1). Roger/Mark
+ Comms bug fixes.
+
+2). Jal
+ Circular buffer bug fix.
+
+3). Roger
+ RThread::Duplicate() fix.
+
+4). Jane
+ Improved the build system. Added mnt cleanup, mnt cleanwins and mnt
+ cleanx86 which delete all the intermediate files for all builds, just
+ WINS and just X86 respectively. A cleanup should always be performed
+ before the first build of a new release of E32.
+
+ Fixed clean-up of a thread's kernel server session when it dies.
+
+ DPlatThread::Create() was not opening the thread it created, and thus
+ the access count was too low, causing death when the thread died. Fixed.
+
+ Fixed TTimerInt::TimerComplete() to switch interrupts off during the
+ non-atomic decrement of the dfc pending flag.
+
+ Made CObject::AccessCount() public rather than protected - mainly for use
+ in debugging.
+
+5). Geert
+ Changed to a new scheme for boolean values. As the change has considerable
+ impact there is a fair amount of material here, including some background
+ information. Feel free to skip anything that looks familiar:
+
+ In a statement such as
+ if (cond) s1;
+ else s2;
+ C++ will execute s1 if cond!=0, and s2 if cond==0. In general, C++ treats
+ boolean values as false if they are equal to zero, and true if they are
+ anything else. The if statement, ?:, &&, || and ! operators all work on
+ this assumption.
+
+ However, the _result_ of a C++ calculation with boolean values is defined
+ to be zero for false, and (int) 1 for true: the built-in &&, ||, !, ==,
+ !=, <, >, <= and >= operators all return either 0 or 1.
+
+ Thus, although 1 is the most usual value representing 'true', it is not
+ the only value that can mean 'true'. It is therefore _bad practice_ to
+ compare any boolean variable with 1 (or ETrue, or TRUE), to see whether
+ it's true:
+ if (x==ETrue) s1;
+ will only execute s1 if x==1, whereas
+ if (x) s1;
+ will execute s1 if x!=0, which is the correct definition of 'true'ness.
+
+ The draft ANSI C++ standard includes a 'bool' type that has the right
+ properties. The TBool introduced here has two main design goals:
+ (i) when ANSI compilers become widely available, it will be possible to
+ replace the current type definition with
+ typedef bool TBool;
+ and everything will work perfectly
+ (ii) it is designed to cause the compiler to generate an error message
+ whenever a TBool is compared with ETrue. This forces you to fix code that
+ is potentially in error, before your code will successfully compile.
+
+ TBool is no longer an enumeration. It is now an integral type best thought
+ of as the type of boolean operators such as <, ==, !=, etc. The only
+ significant property of its values is whether they are zero (false) or
+ non-zero (true). The EFalse and ETrue enumeration constants are available
+ as boolean literals, but a TBool does _not_ have to be equal to ETrue to
+ be considered true.
+
+ This has some impact on the kinds of expressions you can meaningfully
+ write using TBools. Comparisons between boolean variables are meaningless,
+ for instance. On the other hand, a statement such as
+ if (x==EFalse) s1;
+ is equivalent to
+ if (!x) s1;
+ which is not only more concise but also more expressive in many contexts.
+
+ The most common meaningless expressions involving TBools; i.e., the likes
+ of
+ if (x==ETrue) s1;
+ are trapped at compile time, or link time at the latest. Use
+ if (x) s1;
+ instead.
+
+ Another commonly used construct is
+ return(x ? ETrue : EFalse);
+ where the conditional is now entirely redundant. As a side effect of the
+ definition of EFalse and ETrue, this code no longer compiles. Examples of
+ other code intended to achieve the same effect are:
+ return((TBool)(x));
+ or
+ if (x) return(ETrue);
+ else return(EFalse);
+ or one of many variants. These are not picked up by the compiler.
+
+ Comparisons of one TBool to another are not trapped, nor are other
+ meaningless constructs such as
+ if (x<=ETrue) s1;
+
+ To help the human reader, all boolean values should be declared as TBool,
+ including: member data; function parameters taking booleans; functions
+ returning booleans and especially overloaded boolean operators such as
+ operator==(), operator!=() etc. Where booleans are packed into TInt8s or
+ the like to save space, consider using a flags word instead.
+
+ In rare cases TBools may have to be converted into integer values. This
+ may be the case when packing booleans into bytes, or when streaming them
+ out. One elegant and efficient way of doing that is to compare to EFalse;
+ e.g.,
+ TUint8 iPresent[aColorComponent]=(TUint8)(aComponentPresent!=EFalse);
+ Just casting is not sufficient because vital non-zero bits in the incoming
+ boolean may be lost.
+
+ Moreover, it is sometimes useful to assert things about the exact integer
+ value of a boolean. One example of this is test code. The built-in boolean
+ operators return either 0 or 1. It may be desirable to specify the same
+ behaviour for overloaded operators or even ordinary member functions. Use
+ the FALSE and TRUE macros in those cases; e.g.,
+ test((des1<des2)==TRUE);
+
+ The macros may also be useful when an ordinary integer is regarded as a
+ boolean. The E32Dll() entry point returns a TInt, for instance. FALSE and
+ TRUE may be used in that context. Another use is at the interface with
+ external code, such as the Win32 API. As a final example: a callback
+ function to be used in the context of a CIdle object might use the macros,
+ since its TInt return value is interpreted as a boolean.
+
+ Note that the conversion to this new scheme is only partially implemented
+ in the base.
+
+6). Steve
+ New functions TSize TPoint::AsSize and TPoint TSize::AsPoint return
+ this as the respective type. Removed overloaded functions in TPoint,
+ TSize and TRect.
+
+ TSize::SetWH renamed to SetSize.
+
+ TRect - Functions renamed from Offset to Move and Normalise to
+ Normalize. New functions: Size, Width, Height, IsNormalized, Center,
+ SetSize, SetWidth and SetHeight.
+
+
+Version 0.01.049
+================
+(Made by Matthew, 21 Nov 1995)
+
+1). Andrew
+ The constness of the parameters to CCleanup::PushL and
+ CleanupStack::PushL has gone.
+
+ CCleanup and CleanupStack now have an extra PushL overload: This
+ takes a TCleanupItem, which is callback. This enables any component
+ to be placed on the cleanup stack by providing a implicit cast to
+ TCleanupItem: the component will require a static member which conforms
+ to the TCleanupOperation prototype, with which it can constuct a
+ TCleanupItem. The overhead of all this is negligible _only_ if the cast
+ operator is inline!
+
+ See the RItem class in the T_CTRAP test code for an example of how to
+ do this.
+
+ It is possible to push a no-data callback on the stack, though the function
+ must take a dummy TAny * parameter. Such a function can be PushLed
+ directly, as TCleanupItem provides a constructor from a TCleanupOperation.
+
+
+2). Jane
+ Added code for the WINS platform to allow DLLs to startup in a chosen
+ order. When E32Dll() is first called (aReason==EDllProcessAttach), a new
+ function UserSvr::InitRegisterCallback(TCallBack t, TInt p) should be
+ called. This registers t as a callback function with priority p. All the
+ start-up functionality of E32Dll() should now be moved to the callback.
+
+ After all the DLLs have been loaded, the kernel runs through a priority
+ queue, doing callbacks in the requested order, and waiting on a semaphore
+ between each call. Before it terminates, the callback function should call
+ UserSvr::ServerStarted() to signal the semaphore, and allow the kernel to
+ callback to the next DLL's registered function.
+
+ See the t_start files in TADT.
+
+ Added support for sharing loading of dlls.
+
+ Fixed the thread cleanup code to correctly free resources owned by the
+ session, and exit cleanly if the thread creation failed due to lack of
+ heap. Should fix HA-7.
+
+3). Matthew
+ CObject::Close now panics if the access count becomes negative, new test
+ code checks this.
+
+ In WINS, PP:MapLastError returns KErrDoesNotExist for the NT error code
+ ERROR_MOD_NOT_FOUND. This fixes HA-22.
+
+ Added a function RLibrary::LoadExact which loads a DLL without mangling
+ the name. To use this you will need F32 build 13.
+
+4). Roger
+ Added __DEBUGGER() Macro.
+
+ Under WINS and MX86 this macro will place an inline int3 instruction into
+ your code. For ARM builds the macro expands to a SWI instruction.
+
+ The macro compiles out under release builds.
+
+ Under WINS __DEBUGGER() will cause the application to drop into the
+ debugger - it will also invoke just in time debugging if your system has
+ it enabled.
+
+ There is no kernel debugger support for ARM or MX86 builds.
+
+ The Macro is currently defined in E32STD.h this is a temporary measure
+ until there is a good area for platform specific pre-processor macros.
+
+ Fixed the two DPlatThreads with the same NT thread id in the kernel's
+ list of threads bug, HA-16 and HA-6.
+
+5). Graham
+ New ARM code, added function TEiger::BootWaitMilliseconds(), changed
+ ArmVectorIrq() and CScreenDriverMarm::Blit().
+
+
+Version 0.01.048
+================
+(Made by Jane,13 Nov 1995)
+
+1). Colly
+ If a function has a parameter by reference immediately before the
+ ellipsis argument as in:
+
+ RTest::Printf(const TDesC &aFmt,...)
+
+ then there is a problem when using the variable argument macros as
+ follows:
+
+ VA_LIST list;
+ VA_START(list,aFmt);
+
+ since the macro use &aFmt to try and get the address of the argument
+ on the stack. However this does not work with arguments passed by
+ reference since &aFmt is the real address of the descriptor. I have
+ been using a special function User::SetVaArgList() to overcome this
+ difficulty. However this function does not work with register calling
+ conventions as for the ARM compiler and so a better solution has been
+ found. Many thanks to Geert for the solution as follows:
+
+ A new class has been defined TRefByValue as follows:
+
+ template <class T>
+ class TRefByValue
+ {
+ public:
+ inline TRefByValue(T &aRef);
+ inline operator T &();
+ private:
+ TRefByValue &operator=(TRefByValue aRef);
+ private:
+ T &iRef;
+ };
+
+ The assignment operator is just to stop the compiler whining since
+ it cannot generate the assignment operator. The trick is to pass a
+ reference by value and then have a cast to return the refernce again.
+ So all that needs to change is the function declaration as follows:
+
+ RTest::Printf(TRefByValue<const TDesC> aFmt,...)
+
+ Note that the TRefByValue is now passed by value so that
+
+ VA_START(list,aFmt)
+
+ will now work. SetVaArgList has now thankfully been banished.
+
+ NOTE: No functions calling these functions with ... should need
+ to be changed.
+
+ As a consequence of this change three pairs of overloaded functions
+ are now ambiguous:
+
+ TDesC::Format(TRefByValue<const TDesC8> aFmt,...); and
+ TDesC::Format(const TDesC8 &aFmt,VA_LIST aList);
+ TDesC::AppendFormat(TRefByValue<const TDesC8> aFmt,...); and
+ TDesC::AppendFormat(const TDesC8 &aFmt,VA_LIST aList);
+ TLex::Convert(TRefByValue<const TDesC8> aFormat,...);
+ TLex::Convert(const TDesC8 &aFormat,VA_LIST aList);
+
+ Resolved the ambiguity in each case by renaming the function which
+ takes the VA_LIST argument to end in List, i.e.
+
+ TDesC::FormatList(const TDesC8 &aFmt,VA_LIST aList);
+ TDesC::AppendFormatList(const TDesC8 &aFmt,VA_LIST aList);
+ TLex::ConvertList(const TDesC8 &aFormat,VA_LIST aList);
+
+2). Colly
+ A mis-understanding between myself and Nick Twyman caused me to
+ change EXPORT_C to be defined empty. This is not correct and I have
+ put it back to the correct #define EXPORT_C __declspec(dllexport)
+
+3). Colly
+ Fixed a bug in the TReal96 class which then showed up a failure
+ in the implementation of TReal96. TReal96 on being Set() was always
+ shifting the mantissa left three and then subtracting 3 from the
+ exponent. However all the function were not allowing for this. I
+ have changed the Set() code not to to the shift any longer. So if
+ real calculations are to be performed the shift will have to be
+ done before the calculation. GetTReal() and the cast to TReal
+ normalise as before. GetTReal() had a bug in that it was
+ normalising *this along the way to converting to a TReal. It should
+ in fact do nothing and be changed to a const function. Two new
+ functions need to be added, Normalise() and Prepare(). Normalise()
+ will do most of what GetTReal() is doing now but will do it directly
+ on *this, while Prepare() will do the left shift by three.
+
+4). Colly
+ Changed all executive services to have 4 or less arguments to suit
+ the calling convention of the GCC compiler. i.e. all arguments are
+ in registers.
+
+5). Colly
+ Added the ARM implementation of Epoc/32 for the Eiger chip and finally
+ got a workable release of the GNU tool chain from Cygnus. Work is now
+ progressing on getting Epoc/32 running on Eiger.
+
+6). Graham
+ Various Eiger fixes.
+
+7.) Jane
+ Changed build system adding the verbs mnt cleanup (deletes everything from \e32sys
+ and \work\e32\...) and mnt blddef (automated build of all the .def files into
+ \E32\BWINS and \E32\BMX86 directories). Made several changes to the DEFMAKE tool
+ to support this.
+ These should only need to be used by the base team - others can continue to
+ use mnt bldall etc. as usual.
+
+8). Matthew
+ Test code for CPeriodic and TDayName etc added.
+
+ Fixed rounding bug in um_rtod.cpp (HA-15) & adapted Martin Hardman's test
+ code.
+
+9). Jane
+ Fixed HA-13, setting iBase=0 in DestroyAll(), and wrote test code. Note that
+ DestroyAll() is due to be replaced by a function in a new class CArrayFixFlatCBase
+ which will subclass CArrayFixFlat<CBase *> and thus can be type safe.
+
+10). Jane
+ Changed EXE header format in kernel and E32ROM to contain stack & heap maximum
+ and minimum sizes.
+
+11). Jane
+ MMU - added allocation of linear regions (chunks) from high memory for DLLs, and
+ wrote test code.
+
+12). Morgan
+ Maths fixes.
+
+ T_MATH.CPP:
+ 2 sin tests (lines 1317-1321) were failing with the new TReal96 due to inaccurate
+ values for sin(3) and sin(4).
+
+ lntest4 now uses a bit test ( using the 'approx' class) to compare the results taking
+ into account any bit wobble.
+
+ UM_INT.CPP:
+ Fixed Math::Int(TReal &aTrg,const TReal &aSrc) aSrc.Exp() = KMantissaBits-32.
+ (Left shifting a TInt by 32 (eg x<<32) results in 0xffffffff when it was required to be 0).
+
+ UP_I64.CPP
+ Added TInt64A::MulTop which returns the top 64 bits of a 64x64->128 multiply.
+
+ UM_R96.CPP - TReal96 functions
+ Set() now writes the correct exponent for a 56 bit mantissa (and is consistent with the
+ transendental fuctions when KMantissaBits=56)
+
+ Added TMathPanics
+
+ Added test code for TReal96, RChunks and more tests for Int64
+
+
+13). Colly
+ Various X86 keyboard fixes.
+
+14). Martin
+ Changed Alloc heaven 'dialog' so that address of offending cell is visible.
+
+ Added a Replace function to descriptors (courtesy of Brendan), with test code.
+
+ Fixed TPtr::Set function to do the right thing with maxlen, modified test code.
+
+15). Graham
+ Windows server changes.
+
+16). Jane
+ Added KBX86 and KBARM boot source to PVCS.
+
+
+Version 0.01.047
+================
+(Made by Colly, 9 Oct 1995)
+
+1). Changed all TUint to TInt.
+
+2). The UserSvr::RequestEvent(TEvent &anEvent,TRequestStatus &aStatus)
+ was unworkable for the Epoc/32 micro-kernel variants since the
+ O/S needs to write the resulting event back in the context of the
+ interrupt which may not be the same process as that requesting the
+ event. Like servers, this needs to be written using RThread::Write()
+ which needs to write to a descriptor in the requesting process. To
+ this end I have defined:
+
+ class TEventBuf : public TPckgBuf<TEvent>
+ {
+ public:
+ inline TEvent &Event() const {return(*((TEvent *)&iBuf[0]));}
+ };
+
+ The function now becomes:
+
+ UserSvr::RequestEvent(TEventBuf &anEvent,TRequestStatus &aStatus);
+
+ i.e. it takes the packaged event. The actual event can be returned
+ by using the () operator on the package or by calling Event().
+
+3). The text window server had a bug which was causing the unicode
+ release build to fail reading the setup parameters in a random way.
+
+4). CObjectIx::Destruct() was deleting NULL object handles. Fixed.
+
+5). Made TRequestStatus a proper class so that it is now strongly typed.
+ This helps the compiler pick the correct overloaded function as
+ can happen in the file server for example. Note that there is no
+ conversion from a TRequestStatus to a TInt. Use the Int() function.
+
+6). ROM sizes are now quoted for the Epoc/32 microkernel builds and
+ not for WINS as previously.
+
+ROM SIZES
+
+ X86 ARM
+ --- ----
+EUSER.DLL 94K 154K
+EKERN.DLL 70K 110K
+ELOCL.DLL 3K 3K
+EFSRV.DLL 27K 41K
+----------------------
+TOTAL 194K 308K
+----------------------
+
+Version 0.01.046
+================
+(Made by Colly, 2 Oct 1995)
+
+1). Added #defines _L8, _L16, _S8 and _S16 for string literals.
+
+2). Eliminated wait handlers for device drivers. The function
+ User::AllowRequestsToComplete() is now redundant. Withdrawn.
+
+3). KMinTInt8 and KMinTInt16 were not defined correctly. Fixed.
+
+4). Completed the implementation of RHeap(). The various UserHeap
+ creation functions now have new arguments, aMinLength,
+ aMaxLength and aGrowBy. The heap will initially be aMinLength
+ in size, and can grow to be aMaxLength in size. If there is no
+ space in the heap then an attempt will be made to grow the heap
+ in aGrowBy increments. There is a new function Compress() which
+ will free any excess space at the end of the heap. Compress() will
+ never shrink the heap to less than aMinLength. The sizing code has
+ been modified to take account of the RHeap structure at the bottom
+ of the heap, so that the free size of a newly created heap will
+ always be >= aMinLength. None of this affects fixed heaps.
+
+5). Changed RThread::Create() to allow the initial size of the heap
+ to be specified as well as the maximum size of the heap. These
+ are given as the aHeapMinSize and aHeapMaxSize parameters. All
+ heaps created in chunks are targets for compression if the system
+ runs out of memory.
+
+6). Implemented the process handling functions for the first time in
+ the micro-kernel version, including an interface to allow a loader
+ server to actually load .EXEs and .DLLs. In a normal system the
+ loader server will be part of the file server. The 486 version
+ of Epoc/32 now supports multiple processes, full pre-emptive
+ scheduling, and execute in place .DLLs and .EXEs.
+
+7). Added User::Beep(TInt aFrequency,TInt aDuration). The frequency
+ is in hertz so 440 is middle A. The duration is in tenths
+ of a second. As in Epoc/16 a negative duration indicates that if
+ the hardware to perform the beep is being used for another purpose
+ no beep will be sounded. As before if the duration is positive the
+ beep can hang up the program until the hardware is free to make
+ the beep. And as before the first beep will return immediately if
+ the hardware is not busy and the beep will continue in background.
+ Note that in Epoc/16 the frequency was specified as an interval.
+ This function is not playing a sound constinuously due to a bug in
+ Win32. It is however functionally correct. I will fix it in the
+ next release.
+
+8). The constructor for the TPckg template class was leaving the
+ length of the descriptor as zero, when it should be the sizeof
+ the object T. Fixed.
+
+9). Add support for drivers to the kernel. In Epoc/16 there were LDDs
+ and PDDs. In Epoc/32 a Device is equivalent to an LDD and a Driver
+ is equivalent to a PDD. The only user mode services for drivers
+ are TFindDriver which allows all installed drivers to be listed
+ and User::LoadDriver() and User::FreeDriver(). With the addition
+ of drivers \E32\KSRC\KS_DEV.CPP got too big to handle so I have
+ split out channels into KS_CHN.CPP and libraries (DLLs) into
+ KS_LIB.CPP and put drivers in KS_DRV.CPP.
+
+10).Completed the implementation of the device driver functions in the
+ kernel and implemented the RDevComm device as well as a WINS driver.
+ Ax X86 driver for 16450s and 16550s is coming soon. Serial comms lives
+ again! The comms device and WINS driver are now part of the standard
+ release of E32 for WINS. The interface to the device is in D32COMM.H
+ and D32COMM.INL. It is necessary to load both the device driver
+ and the physical driver in order to use the comms device. An example
+ of how to do this is in \e32\dpwins\t_comm.cpp.
+
+11).Added a public function CActive::Deque() which will allow the
+ active object to be removed from the scheduler queue. Deque()
+ will call Cancel() before dequeing the object. The object must
+ already be on the scheduler queue to be dequed or else a panic
+ will result.
+
+12).Added a circular buffer template class CCirBuf<T> to E32ADT.H and
+ its test program T_CIRC.CPP. This is used by the serial device
+ to implement receive and transmit buffers. It allows items to be
+ added at the head of the queue while allowing items to be removed
+ from the tail of the queue. The buffers size can be changed
+ dynamically by calling SetLengthL(), although it will discard the
+ current contents of the buffer. Also added a class CCirBufer
+ derived from CCirBuf<TUint8> which add Get() and Put() which will
+ add or remove a single item and are optimised for speed.
+
+13).Added the text window server to the standard build of E32. This has
+ now been implemented for WINS and EPOC/32-MX86 platforms. The source
+ of this server is in \E32\WSRC. It uses a screen driver .DLL
+ to perform character blitting to the screen. The test programs are
+ in \E32\TWIN. The RConsole class has the following facilities:
+
+ RConsole is used to communicate with the text windows server.
+
+ Version() Reports client side version information
+
+ Create() If necessary, opens a connection to the window server, then creates a default window without displaying
+ it. The default window characteristics may then be changed using Control() before proceeding to display
+ the window using Set().
+
+ Set() If necessary, opens a connection to the window server. If necessary, creates a window. Then displays
+ the window with the given title and attaches the given buffer size characteristics to it.
+
+ Write() Writes the given text at the current cursor position.
+
+ Clear() Clears the whole window and places the cursor at the top left corner.
+
+ ClearToEndOfLIne() Clears from the current cursor position to the end of the line
+
+ Destroy() Removes the window from the screen. Another may then be opened using Create()/Set().
+
+ SetCursorSize() Sets the percentage height of the cursor
+ SetCursorPosAbs() Places cursor at given absolute position.
+ SetCursorPosRel() Places cursor relative to current position.
+ CursorPos() Returns current cursor position
+
+ Control() Controls various window characteristics. The text passed to this function may contain near-English
+ commands. However, only the '+', '-', and upper-case letters are actually interpreted:
+
+ '+' Apply subsequent characteristics
+ '-' Remove subsequent characteristics
+ 'V' Visibility
+ 'C' Cursor on
+ 'S' Scroll bars
+ 'L' Scroll lock
+ 'W' Wrap lock
+ 'M' Maximum Window Size
+ 'N' '/n' is CR and LF
+
+ Before interpreting the text, a silent '+' is assumed:
+
+ Control(_L("Visibility -Cursor Lock + Scroll"))
+
+ This would cause the window to become visible, with no text cursor, no scroll lock active,
+ but with scroll bars present. Of course, the following command would achieve exactly the same
+ result, but would not posses the same level of self-documentation or readability:
+
+ Control(_L("VS-CL"))
+
+ Further more, the next command would achieve the same thing with even more readability:
+
+ Control(_L("+Visibility -Cursor -Lock +Scroll"))
+
+ Read() Read a character.
+
+ ReadCancel() Cancel asynchronous read request
+
+14).Set the priority of the kernel server thread and null thread
+ correctly on the EPOC/32 platforms.
+
+15).Now allocating data section base addresses correctly so that multiple
+ threads will now work correctly on the EPOC/32 platforms.
+
+16).Changed THandleBase::Duplicate(RProcess &aProcess) to be
+ THandleBase::Duplicate(RThread &aThread) since it is usual
+ to have the remote thread handle and unusual to have the remote
+ threads process handle. The O/S uses the thread's process as the
+ handle's source process.
+
+17).RTimer.After() and User::After() were using a duration in ticks. This
+ has now been changed to a duration in tenths of a second so that it
+ is platform independent.
+
+18).RProcess RThread::Process() was always returning the current
+ process rather than the thread's process. Also returning a new
+ handle based object can fail with out of memory so I have changed
+ this function to TInt RThread::Process(RProcess &aProcess) so that
+ it can return the error.
+
+19).Under Windows/NT a mutex once owned by a thread can be waited on again
+ without locking the thread, on the basis that this protects a thread
+ from entering deadlock. However this is nonsense since a mutex can
+ be used to prevent a thread from accessing the resource as
+ happens in the case of the User::Beep() function. Basically the
+ mutex is used to lock out threads until the current beep has
+ completed. What takes the thread out of potential deadlock is the
+ beep completing in due course. Changed the WINS implementation to
+ behave correctly and lock the thread.
+
+20).TLex::Val(TReal &) did not fail with a number like _L("1.2e"). Fixed.
+
+21).The default constructor for the TLex class was still being set up for
+ zero terminated descriptors which were discarded in January. Fixed.
+
+22).TLex::Peek() would happily try and access a character from a default
+ constructed TLex which resulted in an access violation. Now fixed.
+ Also dropped inline for Inc(),Peek() and Get().
+
+23).CBufBase::Read(TUint aPos,TDes8 &aDes) is documented as reading up to
+ aDes.MaxLength() characters, but was in fact reading up to
+ aDes.Length() characters. Fixed.
+
+24).RTimer was not setting the request status to KRequestPending after
+ an asynchronous request. Fixed.
+
+25).I have changed EXPORT_C to just be nothing rather than
+ __declspec(dllexport). For the time being it is still required to
+ declare functions as EXPORT_C. If you had a function which did
+ not have a corresponding IMPORT_C then make sure that there is
+ an IMPORT_C defined somewhere or else the function will not be
+ exported.
+
+26).Changed the heap checking macros to have understandable names and have
+ simplified their implementation. I have also made them orthogonal. The
+ new names and their old equivalents are as follows:
+
+ // For the user heap
+
+ __UHEAP_MARK MARKSTART
+ __UHEAP_CHECK(aCount) CHECKNUM1(x)
+ __UHEAP_CHECKALL(aCount) CHECKTOTALNUM1(x)
+ __UHEAP_MARKEND MARKEND
+ __UHEAP_MARKEND(aCount) MARKEND1(x)
+ __UHEAP_FAILNEXT(aCount) SETFAIL(x,y)
+ __UHEAP_SETFAIL(aType,aRate) SETFAIL(x,y)
+ __UHEAP_RESET RESET
+
+ // For the kernel heap
+
+ __KHEAP_MARK
+ __KHEAP_CHECK(aCount)
+ __KHEAP_CHECKALL(aCount)
+ __KHEAP_MARKEND
+ __KHEAP_MARKEND(aCount)
+ __KHEAP_FAILNEXT(aCount) K_SETFAIL(x,y)
+ __KHEAP_SETFAIL(aType,aRate) K_SETFAIL(x,y)
+ __KHEAP_RESET K_RESET
+
+ // For any RHeap
+
+ __RHEAP_MARK(aHeap) MARKSTART1(x)
+ __RHEAP_CHECK(aHeap,aCount) CHECKNUM2(x,y)
+ __RHEAP_CHECKALL(aHeap,aCount) CHECKTOTALNUM2(x,y)
+ __RHEAP_MARKEND(aHeap) MARKEND1(x)
+ __RHEAP_MARKEND(aHeap,aCount) MARKEND2(x,y)
+ __RHEAP_FAILNEXT(aHeap,aCount) UH_SETFAIL(x,y,z)
+ __RHEAP_SETFAIL(aHeap,aType,aRate) UH_SETFAIL(x,y,z)
+ __RHEAP_RESET(aHeap) UH_RESET
+
+ FAILNEXT,UH_FAILNEXT and K_FAILNEXT can be replaced
+ with __?HEAP_FAILNEXT(1)
+
+ It is no longer possible to check a threads heap since this will
+ not work under Epoc/32 if a thread is in another process.
+
+ In the first trial implementation of __?HEAP__FAILNEXT(aCount) I
+ had not realised that aCount did not do anything. This is now
+ fixed. Note that aCount==1 fails the next alloc call.
+
+27).The member variable of TScreenInfoV01 were not declared with a lower
+ case i prefix. Fixed.
+
+28).Released the console classes. The header for the console class in
+ E32CONS.H. It has an abstract base class CConsoleBase which just
+ defines a basic set of console functions. It also has CConsoleTextWin
+ which is the console implementation for the text window server.
+
+29).Changed the WINS platform to use the the CConsoleTextWin instead of
+ a second Windows/NT console window. The test class now uses the
+ CConsoleTextWin. The console is released as ECONS.DLL. The
+ CConsoleTextWin class is defined in the E32TWIN.H header.
+
+30).Changed the test class to use the console. Also added a Getch()
+ function to the test class. Because it now owns a console object
+ I have had to rename the test class RTest. I have also added
+ a Close() member function which will free an allocated console.
+
+31).Added CConsoleBase *Adt::NewConsoleL() which will create a basic
+ console object. Note that you do not need to be linked to ECONS.LIB
+ in order to use this or any of the member functions of CConsoleBase.
+
+32).Took the opportunity with the release of the X86 platform to rename
+ the WINS platform releaseables to be inline with those of the X86
+ platform. The new names are as follows:
+
+ OLD NAME NEW NAME
+ ============ =============
+ ESTAT.OBJ EEXE.OBJ
+ ESTAT.LIB EEXE.LIB
+ EWINS.DLL EUSER.DLL
+ EWINS.LIB EUSER.LIB
+ KWINS.DLL EKERN.DLL
+ LWINS.DLL ELOCL.DLL
+
+ For programs the programs which use E32 the only changes to .MAK files
+ which are significant are as follows:
+
+ ESTAT?.OBJ to EEXE.OBJ - The startup object for .EXEs
+ ESTAT?.LIB to EEXE.LIB - The startup library for .EXEs
+ if linking with msvcrt20.lib
+ EWINS?.LIB to EUSER.LIB - The user library
+
+33).Added an inline "construct in place" global new operator.
+
+34).Due to popular demand I have moved the following functions
+ to a new class of their own CleanupStack.
+
+ Adt::PushL(const TAny *)
+ Adt::PushL(const CBase *)
+ Adt::Pop()
+ Adt::Pop(TUint aCount)
+ Adt::PopAndDestroy()
+ Adt::PopAndDestroy(TUint aCount)
+
+ become
+
+ CleanupStack::PushL(const TAny *)
+ CleanupStack::PushL(const CBase *)
+ CleanupStack::Pop()
+ CleanupStack::Pop(TUint aCount)
+ CleanupStack::PopAndDestroy()
+ CleanupStack::PopAndDestroy(TUint aCount)
+
+35).For a long time I have been tracking down a race condition under
+ WINS which resulted in the kernel being hung. This turns out to be
+ a bug in the Windows/NT implementation of critical sections.
+ I have replaced the critical section with a mutex which fixes the bug.
+
+36).I have fixed the T_SEMUTX.CPP program which has also long had a
+ deliberate race condition as part of its test. However the problem
+ was that sometimes it raced and sometimes it did not. By making each
+ thread wait different times its possible to always make the race
+ conditions occur so that the test will always pass consistently.
+
+37).The CIdle class was doing a User::WaitForAnyRequest() in the
+ DoCancel() function. DoCancel() should just do nothing ofcourse
+ since the CActive::Cancel() function will do the WaitForAnyRequest().
+ Many thanks to Brendan for spotting the bug and for providing
+ the test code t_idle.cpp.
+
+38).Adt::DestroyZ() was never any use, so I have removed it.
+
+39).CSession::CreateL() was defined as pure virtual so that server
+ implmentors had to define a CreateL() function even, as is often
+ the case, the function did nothing. I have now supplied a default
+ implementation which does nothing.
+
+40).CActiveScheduler::Install() would not allow the current scheduler
+ to be removed by passing NULL. This is now allowed. Note that if
+ you want to change the scheduler you must first de-install by using
+ NULL and then replace with the new scheduler.
+
+41).Got most of the base test code working in release mode. For some
+ unknow reason, some of the test code template classes are not
+ instaniating in release builds. All tests pass but the following
+ have the body of their code eliminated.
+
+ T_BUF, T_CHAR, T_DES, T_HEAPDB, T_HUF
+ T_LEX, T_QUE, T_SQUE, T_KEY, T_FLOAT
+
+ In getting the test programs to work in the release build almost
+ all problems wre due to a dependency on the lifetime of
+ temporaries. In debug builds temporaries are never re-used so they
+ exist for the duration of the function. However in release builds
+ they are re-used at the first opportunity. Typical buggy code is
+ as follows:
+
+ class TBug
+ {
+ public:
+ TBuf();
+ void Set1(const TDesC *aDes);
+ void Set2(const TDesC *aDes);
+ private:
+ const TDesC *iPtr1;
+ const TDesC *iPtr2;
+ };
+
+ TBuf b;
+ b.Set1(&_L("Temporary 1"));
+ b.Set2(&_L("Temporary 2"));
+
+ This will work fine in debug builds but will result in iPtr1 and
+ iPtr2 pointing to the same value. This is because _L is defined
+ as a constructor for a TPtrC which creates a temporary. The same
+ automatic space will be used for the temporary.
+
+42).HBufC::NewMax(),HBufC::NewMaxL() and HBufC::NewMaxLC() all ended
+ up setting the length to the size of the allocated cell which can
+ be bigger that the requested length. Changed to set the length
+ to the requested length.
+
+43).Moved MemCopy(),MemCompare(),MemCompareF(),MemCompareC()
+ MemFill(),MemFillZ() and MemSwap() to a class of their own
+ called Mem and dropped the Mem prefix. So User::MemCopy() is
+ now Mem::Copy() etc.
+
+44).Changed TDesC functions Match(),Locate(),LocateReverse() and Find()
+ to return an unsigned result. They all return KNotFound which is
+ defined as KMaxTUint if they fail.
+
+45).The message system was not tidying up correctly when a session
+ was closed by the client or if the client died before closing. The
+ new implementation of messaging has now fixed this problem.
+
+NOTE
+====
+
+20th September 1995.
+
+The X86 implementation of the Epoc/32 platform ran through the
+creation and execution of the first user mode process and then
+eventually ended up in the NULL process and consequently the idle
+loop. The MMU and protection is fully enabled, so this constitutes
+the birth of Epoc/32. We hope to have the remainder of the boot
+sequence, i.e. file server, window server and shell completed
+by the end of the next week.
+
+ROM SIZES
+
+ X86 ARM
+ --- ----
+EUSER.DLL 90K 148K
+EKERN.DLL 33K 47K
+ELOCL.DLL 3K 3K
+EFSRV.DLL 28K 42K
+----------------------
+TOTAL 154K 240K
+----------------------
+
+Version 0.01.045
+================
+(Made by Colly, 30 Aug 1995)
+
+1). Changed the way messaging worked internally. RServer::Receive() used
+ to get a pointer to the message received. I was hoping to pass this
+ pointer directly from supervisor space for efficiency, but I have
+ decided that its not worth the extra overhead of read only shared
+ memory that wouldbe required. RServer now has a RMessage by value
+ which receives the contents of the message when it arrives. If the
+ server needs to hold onto the message then it must either copy
+ the message in full (I have added a copy constructor and an assignment
+ operator to allow this) or it must use the new function MessagePtr()
+ which returns a const RMessagePtr. The only thing you can do with
+ an RMessagePtr is to complete the message as you do with a normal
+ RMessage by call RMessagePtr::Complete().
+
+ While I was about it I also changes the naming of the accessor
+ functions I1(),P1() etc. The problem with the names was that on
+ the client side arguments were being set into an array using normal
+ indexing, i.e. base 0, while on the server side the names were based 1.
+ In order to help the conversion I have renamed I to Int and P to Ptr
+ so that:
+
+ I1() is now Int0()
+ I2() is now Int1()
+ I3() is now Int2()
+ I4() is niw Int3()
+ P1() is now Ptr0()
+ P2() is now Ptr1()
+ P3() is now Ptr2()
+ P4() is niw Ptr3()
+
+ Sorry for the inconvenience.
+
+2). Moved a number of constructors in abstract base classes which were
+ public to protected. This should have no affect other than to stop
+ them being instantiated.
+
+3). Withdrawn the new(ECleanup) and new(ECleanupObj) options. new(ELeave)
+ still exists. CBase * is not nescessarily the start of the heap cell
+ when MI is involved. In general a cast of (TAny *) to a CBase * will
+ not work unless the TAny * was originally downcast to a CBase *. If
+ you know the type T of a TAny *ptr then its o.k. to code
+
+ (CBase *)(T *)ptr;
+
+ but not
+
+ (CBase *)ptr;
+
+4). More tiresome CBase * problems. TDblQue::DeletaAll and
+ TSglQue::DeleteAll were removing each item from the que and then
+ casting the ptr to a CBase * to call Adt::Destroy(). Withdrawn.
+
+5). CActiveScheduler::Start() was not nesting levels correctly. Fixed.
+
+6). Added TLex?::Offset() and TLex?::MarkedOffset().
+
+7). The various TLex::Val() routines should not change iNext if they
+ fail to lex a valid number. Fixed.
+
+8). Added TLex?::Val(TReal32 &aReal,TChar aPoint) and
+ TLex?::Val(TReal64 &aReal,TChar aPoint).
+
+9). Added some extra key difinitions to E32VIRT.H
+
+ EKeyBell=0x0007,
+ EKeyLineFeed=0x000a,
+ EKeyVerticalTab=0x000b,
+ EKeyFormFeed=0x000c,
+ EKeySpace=0x0020
+
+10).Implemented default constructors for TPtrC8 and TPtrC16 which
+ set the pointer NULL and the length to zero.
+
+11).The X86 version of E32 now builds in unicode.
+
+12).Changed CObjectConIx::Remove(CObjectCon *aCon) so that it can be
+ passed NULL. It does nothing if aCon is NULL.
+
+13).Added CObjectCon::operator[]() to allow access to all objects in a
+ container by straight indexing.
+
+Version 0.01.044
+================
+(Made by Colly, 23 Aug 1995)
+
+1). TDes8::SetMax() and TDes16::SetMax() did not work correctly if the
+ TDes was from a TBufC.Des() or HBufC.Des(). This caused the
+ HBufC::NewMax() and HBufC::NewMaxL() to fail to set length to
+ MaxLength(). Fixed.
+
+2). Added a new type TTrapHandler. This is an abstract class which needs
+ to be derived to provide a handler to work with the TRAP mechanism.
+ The trap handler can be installed by calling User::SetTrapHandler()
+ and can be cleared by passing a NULL pointer. By default there is no
+ trap handler. Once a trap handler is installed then each time TRAP is
+ invoked TTrapHandler::Trap() is called. If a leave is called then
+ TTrapHandler::Leave() is called. If the function being trapped does
+ not leave then TTrapHandler::UnTrap() is called. Each thread has its
+ own trap handler. Its not a good idea to install a trap handler while
+ under a TRAP (exercise for the reader to work out why), so a panic
+ will be given if this is attempted. The current trap handler can be
+ retrieved by calling User::TrapHandler().
+
+3). Added a new ADT class CCleanup. The purpose of this class is to
+ provide an automated cleanup mechanism to go with the TTrapHandler
+ facility. This class is basically a stack onto which either
+ allocated cells can be pushed using PushL(TAny *aPtr) or objects
+ derived from CBase with PushL(CBase *aPtr). The object can
+ be popped from the stack with Pop() or popped and destroyed with
+ PopAndDestroy(). It is possible to pop a number of items from the
+ stack by using the overloaded Pop(TUint aCount) functions.
+
+ The object also allows for nesting so that all objects at the
+ current nesting level can be popped or popped and destroyed with
+ PopAll() or PopAndDestroyAll(). These functions automatically
+ decrement the nesting level. The nesting level can be incremented
+ with NextLevel(). When the object is created the level is zero.
+ Objects cannot be pushed while the nesting level is zero so it is
+ necessary to call NextLevel() before doing a PushL().
+
+ If the object is destroyed then all items on the stack will also
+ be destroyed.
+
+ The cleanup object keeps a free slot at all times. Thus an object
+ can always be guaranteed to be added to the cleanup stack. Having
+ added the object, room is made for another free slot. This may
+ leave but it will be alright as the object has already been pushed
+ onto the stack and will be cleaned up. Cleaning up leaves room for
+ another free slot.
+
+4). Added a new ADT class CTrapCleanup which puts 2) and 3) together to
+ give a framework for cleanup. All thats necessary to implement this
+ facility is to call CTrapCleanup::New(). There is no NewL() since
+ the trap handler can only be installed while not under a TRAP.
+ Destroying this object will remove the trap handler. Added the static
+ functions Adt::PushL(const TAny *), Adt::PushL(const CBase *),
+ Adt::Pop(), Adt::Pop(TUint aCount) and the PopAndDestroy()
+ equivalents which all use the installed CTrapCleanup object. Note
+ that the PopAll() variants are not available, since this is done
+ by the trap handler.
+
+5). Added 2 more types to TLeave, i.e. ECleanup and ECleanupObj. ECleanup
+ will allocate the storage and leave on error. If successful it will
+ add the new cell to the cleanup list. ECleaupObj is the same except
+ that it will add the cell as a CBase derived object. It is possible
+ to use ::new with ECleanupObj, but you will just get
+ panicked. It should only be used with CBase::new. Note that any
+ call to new within a member function in a class derived from CBase
+ will be calling CBase::new and so will need ECleanup. If creating an
+ object then ECleanupObj is correct. Using User::AllocLC() is probably
+ preferable and always call new(ECleanupObj) or new(ELeave).
+
+ Added RHeap::AllocLC(), User::AllocLC(), TDesC::AllocLC(),
+ HBufC::NewLC() and HBufC::NewMaxLC() which all are the same as
+ the equivalent L functions except that they add the object to
+ the cleanup list if successful.
+
+ Remember that a Pop() of some kind will be required.
+
+6). Added the function to return machine information from the Hardware
+ Abstraction Layer (HAL). This is retrieved by calling User::HalInfo().
+ The class is declared in E32HAL.H. Setting functions will be added
+ in a forthcoming release.
+ Note that this function takes a TDes8. This is to allow for extensions
+ to the class as developments proceed apace. The function will always
+ fill the entire descriptor with zero and then copy the smaller of the
+ current size of the info class or size of the descriptor. Thus if a
+ new info class is used with an old O/S all new members are guaranteed
+ to be zeroed. If an old info class is used with a new O/S only the
+ appropriate slice of the new info struct is returned. There is a
+ typedef for a packaged THalInfoV1 called THalInfoV1Buf which can be
+ passed to User::HalInfo(). Ofcourse later version will be derived
+ from THalInfoV1 as THalInfoV2 and so on, leaving a clear picture of
+ what has been added between versions. The object can be retrieved
+ from the package as follows:
+
+ THalInfoV1Buf b;
+ User::HalInfo(b);
+ THalInfoV1 &info=b();
+ test.Printf(_L("Machine name = %S\n"),&info.MachineName());
+
+ See the test program \E32\TCDT\T_HAL.CPP for details.
+
+7). The O/S was running DLL startup procedures before starting the file
+ server and window server threads. It has to do this to allow the
+ Window and File server DLLs to register their threads so that they
+ can be started in an ordered manner. However many other servers
+ like the alarm, comms and secokets servers would also like to start
+ the server thread from their E32Dll() entry point. The solution is
+ to hang all starting threads except the Window and File server
+ threads until the Window and File server threads have started.
+
+8). Changed the RLibrary::Load() function so that it will automatically
+ add the approriate suffix for the current build. Thus if the file
+ server wants to load a .DLL called "elocal.fsy" it just uses
+ "elocal.fsy". The O/S will look for the .DLL names as follows:
+
+ Build Source Suffix Target
+ ============ ============ ====== ==============
+ ansi release "elocal.fsy" none "elocal.fsy"
+ ansi debug "elocal.fsy" d "elocald.fsy"
+ uni release "elocal.fsy" u "elocalu.fsy"
+ uni debug "elocal.fsy" ud "elocalud.fsy"
+
+ Because of 8 character name limits the maximum length name of a DLL
+ can only be 6 characters. If an extension is not supplied it will
+ be assumed to be .DLL.
+
+9). Added TPtrC8::Set(const TDesC8 &aDes) and TPtr8::Set(const TPtr8 &aPtr)
+ and the TPtrC16 and TPtr16 equivalents.
+
+10).The resource file \E32\KPWINS\KWINS.RC was including afxres.h from
+ \msvc20\mfc\include which is not actually required. Fixed.
+
+11).Fixed a bug in TLex::Val(TInt?) which has been lurking from day one
+ and was scraping by through good fortune.
+
+12).Fixed a bug in creating global operating system objects such as
+ RSempahores etc.
+
+13).Changed CArrayPakBase to be derived directly from CBase rather
+ than CArrayVarBase. This was being done to share code but because
+ of the public inheritance it caused some nasty problems since a
+ CArrayPakBase is definitely not ISA CArrayVarBase. Users of this
+ class note that the sort function is SortL() and not Sort() since
+ it makes a copy of the array as a CArrayVar and then sorts it.
+ Making the copy can clearly fail. Also note that since the sort is
+ actually performed on a CArrayVar the key for SortL() needs to be
+ a TKeyArrVar. Other functions take a TKeyArrPak as normal. No code
+ should be affected by this change.
+
+14).Added const TArray<T> Array() to each of the array template classes,
+ which allows a degree of polymorphism amongst the arrays.
+ TArray<T> only allows const T &operator[]() and Count().
+
+ If you want a function to be able to read any of the arrays then
+ declare it as follows:
+
+ void ReadAnyArray(const TArray<TBuf_40> anArray);
+
+ It could use the TArray as follows:
+
+ TUint count=anArray.Count();
+ for (TUint i=0;i<count;i++)
+ test.Printf(_L("%S\n"),&anArray[i]);
+
+ Then if you have:
+
+ CArrayFixFlat<TBuf_40> *fix;
+ CArrayFixFlat<TBuf_40> *var;
+ CArrayFixFlat<TBuf_40> *pak;
+
+ They can all be passed to ReadAnyArray() as follows:
+
+ ReadAnyArray(fix->Array());
+ ReadAnyArray(var->Array());
+ ReadAnyArray(pak->Array());
+
+15).SteveT was getting a weird problem with delete in one of
+ his CBase derived classes with the virtual destructor calling the
+ delete from the Windows library. The fix to his problem is to
+ provide CBase::operator delete() even though its not necessary.
+
+Version 0.01.043
+================
+(Made by Colly, 21 Aug 1995)
+
+1). Renamed CBufFlat::Capacity() to CBufFlat::SetReserveL().
+2). Added the L suffix to all the methods in the ADT classes which
+ can leave.
+ CBufBase::InsertL(), CBufFlat::InsertL() and CBufSeg::InsertL().
+ CArrayFix::AppendL(), CArrayVar::AppendL() and CArrayPak::AppendL().
+ CArrayFix::InsertL(), CArrayVar::InsertL() and CArrayPak::InsertL().
+ CArrayFix::InsertIsqL(), CArrayVar::InsertIsqL() and CArrayPak::InsertIsqL().
+ Note that all occurences of ISQ (uppercase) have been changed to
+ lower case. Thus FindISQ() has become FindIsq().
+ Note also that the virtual function InsertL() has been renamed to
+ DoInsertL(), so that the derived classes do not have to re-define
+ the two new InsertL()'s in CBufBase.
+3). The CArray classes had a kludged way of delaying allocation of the
+ CBufBase. Fixed.
+4). Incorporated SteveT's changes to TPoint, TSize and TRect. His release
+ notes are as follows:
+ There are 3 changes to the TRect spec as agreed with Martin Tasker:-
+ Replaced
+ TInt TRect::InterSect()
+ with
+ void TRect::InterSection() &
+ TBool TRect::Intersects()
+ Changed the names of:-
+ TRect:Union() to TRect::BoundingRect()
+ TRect::Inside() to TRect::Contains()
+ I have also removed most of the inline functions from the TPoint,
+ TSize & TRect functions. The only ones left as inline are the
+ TPoint & TSize constructors and operator=, although I'm still not
+ too sure whether they should stay inline or not.
+5). Changed CBufBase::Ptr() and CBufBase::BackPtr() to return TPtrs
+ rather than pointer and length.
+ Added CBufBase::Read(TUint aPos,TDes8 &aDes)
+ which will read aDes.Length() bytes.
+ Added CBufBase::Read(TUint aPos,TDes8 &aDes,TUint aLength)
+ which will read aLength bytes.
+ Added CBufBase::Write(TUint aPos,const TDesC8 &aDes)
+ which will write aDes.Length() bytes.
+ Added CBufBase::Write(TUint aPos,const TDesC8 &aDes,TUint aLength)
+ which will write aLength bytes.
+ Added CBufBase::InsertL(TUint aPos,const TDesC8 &aDes)
+ which will insert aDes.Length() bytes.
+ Added CBufBase::InsertL(TUint aPos,const TDesC8 &aDes,TUint aLength)
+ which will insert aLength bytes.
+6). Removed the protected destructor (not actually implemented) from CBase
+ and changed CBase::Destroy() so that it does not delete this.
+
+ Renamed CBase::Destroy() as CBase::Destruct() and all other
+ virtual Destroy()s to Destruct().
+
+ Changed Adt::Destroy() to call delete after the Destruct().
+
+ This allows CBase derived objects to be aggregated by value, although
+ it is not Psion policy to do this (preferring to aggegrate by reference).
+
+ Note that there is no longer any requirement to call CBase::Destroy()
+ from classes derived from CBase.
+
+ Note that if aggregating by reference which should be the case for
+ all Psion code then the object must be destroyed with Adt::Destroy()
+ rather than the Destruct() function. Its probably a good idea to
+ search all code for ->Destroy() and check each case. Also make sure
+ that all classes derived from CBase which have virtual void Destroy()
+ are changed to virtual void Destruct().
+7). CObjectIx, CObjectCon and CObjectConIx could all be created with
+ optional leave on error. This is not in the spirit of
+ the ADT classes and so I have removed the option. They will now
+ always leave on errors. The methods have been renamed where
+ applicable with the L suffix. These classes were also privately
+ derived from CArrayFixFlat<T> which was breaking the ISA
+ relationship with CBase, which prevents use of Adt::Destroy().
+ They now have a CArrayFixFlat<T> and are derived directly from
+ CBase. CObject and CObjectCon used to capitalise the name. They
+ are now case sensitive on the names. Note this affects server
+ names (watch out SteveT and Brendan).
+8). TPckg<T>::operator->() and TPckg<T>::operator()() were returning
+ const T * and const T & respectively. Fixed.
+9). Added HBufC::NewMax() and HBufC::NewMaxL() which allocate an HBufC
+ of the requested size and then set the length to the maximum length.
+ Note in the proposals database a function it was agreed to add
+ a function SetLengthToMax() to TDes. This has been done but I decided
+ to call it SetMax(). Obviously these functions are available for 8
+ and 16 HBufC's as well.
+10).If multiple inheritance is to be allowed for then the only way to
+ guarantee that an Adt::Destroy() through a CBase pointer will work
+ correctly is to have a virtual destructor. This has been implemented
+ in CBase. No derived classes need to be changed as the compiler will
+ generate the appropriate destructors automatically. If this seems
+ like a waste then I have to agree, however it will make us compatible
+ with the C++ language and all proper C++ implementations. If you want
+ to know more details then ask me, Gerry or DavidW.
+11).The ENTER,CATCH,END_ENTER mechanism had a serious flaw when using
+ a register calling convention. This has now been replaced with the
+ pre-processor macros TRAP and TRAPD. These are defined as below:
+
+#define TRAP(_r,_s) {TTrap __t;if (__t.Trap(_r)==0){_s;TTrap::UnTrap();}}
+#define TRAPD(_r,_s) TInt _r;{TTrap __t;if (__t.Trap(_r)==0){_s;TTrap::UnTrap();}}
+
+ Basically _r is an integer variable which will receive the result of
+ any User::Leave() and _s is a statement to be executed. It can be any
+ valid C++ statement, but will normally be a function call.
+
+ The difference between TRAP and TRAPD is that TRAPD will declare the
+ integer variable for you. The integer variable will always be
+ initialised to 0 before the statement _s is executed. It is possible
+ to use a number of statements for _s by separating them with ; but
+ this will possibly lead to failure.
+
+ Examples:
+
+ CSomething *pS=new(ELeave) CSomething;
+ TRAPD(ret,pC->ConstructL())
+ if (ret!=KErrNone)
+ {
+ Adt::Destroy(pS);
+ User::Leave(ret);
+ }
+
+ is the same as
+
+ CSomething *pS=new(ELeave) CSomething;
+ TInt ret;
+ TRAP(ret,pC->ConstructL())
+ if (ret!=KErrNone)
+ {
+ Adt::Destroy(pS);
+ User::Leave(ret);
+ }
+
+ If you have a function, say TInt DoSomethingL() and you want to
+ get the result of the function or the leave then do this:
+
+ TRAPD(ret,ret=DoSomethingL())
+12).Changed RHeap::Free() to zero the cell it has just freed in the debug
+ build.
+13).Added User::RequestComplete() which will complete a request in for
+ the current thread.
+14).Added a new CDT TCallBack which packages a function taking a TAny *
+ argument and returning an integer with a TAny * value. It has a two
+ constructors, the one which does not have a TAny * value will set the
+ value to NULL. It has one function CallBack which can be used to call
+ the function passing it the TAny * value. e.g.
+
+ class TMyIdle
+ {
+ public:
+ void Run();
+ static TInt Idle(TAny *aPtr);
+ };
+
+ TInt TMyIdle::Idle(TAny *anObj)
+ {((TMyIdle *)anObj)->Run();}
+
+ TMyIdle idler;
+ CIdle *pI=CIdle::New();
+ pI->ConstructL(TCallBack(TMyIdle::Idle,&idler));
+15).Added a new active object CIdle which will call back whenever
+ the active scheduler has scheduled all higher priority objects.
+ CIdle will re-schedule itself as long as the callback function
+ returns TRUE. It can be re-started by calling Start() again.
+ New() and NewL() add the idle object to the scheduler.
+16).Changed CPeriodic to use a TCallBack. Note the CPeriodic::RunL()
+ now always calls the callback.
+17).Added TLex8::UnGetToMark() and TLex16::UnGetToMark() which just
+ reset iNext to iMark.
+18).Renamed all the functions which were in the debug build but not in
+ the release build to have an __Dbg prefix. Also renamed the test
+ functions __TestInvariant() and __Test to __DbgTestInvariant and
+ __DbgTest. This is partly as a reminder to users of these functions
+ that they should only be used inside #if defined(_DEBUG) and partly
+ to ease producing the .DEF file to control the .DLL build process
+ using linkage by ordinal. An automated tool will generate the .DEF
+ file for a .DLL linked by name and will produce the .DEF for the
+ debug build. It can then produce the .DEF for the release build
+ by leaving out all the functions starting with __Dbg.
+
+Version 0.01.042
+================
+(Made by Colly, 3 Aug 1995)
+
+1). All DLLs now link by ordinal.
+2). The release versions had a startup bug with some configurations of DLL
+ useage. DavidW this is what cause the BAFL test code to fail.
+3). Includes the first release of the Epoc/32 microkernel platform and
+ implementation for 486 processor on an IBM/PC.
+
+NOTES
+=====
+
+Its a good idea to turn on DEBUG under link so that release EXEs and DLLs
+have at least the public symbols for debugging. This can be done for
+all build variants. I have done this for all .MAK files in E32 and F32.
+
+Version 0.01.041
+================
+(Made by Colly, 25 July 1995)
+
+1). RThread::Read() failed when reading a descriptor of the type
+ generated by TBufC::Des(). Added a test and fixed.
+2). Made the NULL thread hang around forever instead of exiting to help
+ with debugging.
+3). Added a new directory BWINS to the group which now has all the .MAK
+ files used to build the base. If the .MAK is in the same directory
+ as the source files then the debug databases .PDB files don't store
+ a full path which causes the debugger to prompt for the source
+ directory. Putting them in BWINS causes all paths to be stored in the
+ .PDB. Note that the BLD.CMD files remain where they were they just
+ pick up the .MAK file from BWINS. If using VC++ then load the .MAK
+ file directly from BWINS. Moved the startup files from USTAT to
+ UPWINS and dropped the USTAT directory from the group.
+ Split the startup module us_stat.cpp into two UP_EXE.CPP for
+ starting .EXEs and UP_DLL.CPP for starting DLLs.
+4). Split EWINS into two .DLLs. EWINS still survives but now contains
+ just the user mode functions. KWINS is new and contains the kernel.
+ There is no need to change any .MAK files as it is only the
+ EWINSxx.DLLs which link to KWINSxx.DLL.
+5). Stopped releasing the include file E32CHAR.H.
+6). Merged the E32EVNT.H and E32WSRV.H header files into one header file
+ E32SVR.H which is just for communication with system servers such
+ as the Window server and File server etc. Moved the functions which
+ were in the UserWindowServer class to the UserSvr class and gave
+ the functions better names. Note that I have given the functions in
+ the UserSvr class more meaningful names. SteveT, these changes will
+ affect you!
+7). Fixed missing external references to _fltused, _adj_fdiv, _adjust_fdiv,
+ _adjust_fdivr_m64 and _adjust_fdiv_m64.
+8). Added the functions to support Global and thread local data in DLLs.
+ The functions are as follows:
+
+ TAny *Dll::Tls() - Returns the Thread Local Storage variable for the
+ current DLL.
+ void Dll::SetTls(TAny *aPtr) - Sets the Thread Local Storage variable
+ for the current DLL.
+ Usually in the entry point E32Dll() when the process is attached or
+ when a thread is attached to the DLL some memory will be allocated
+ on the threads heap. This value will then be saved with Dll::SetTls().
+ Thereafter it can be retrieved with Dll::Tls().
+
+ The following functions are not yet fully implemented:
+
+ TBool Dll::GlobalAllocated();
+ TInt Dll::GlobalAlloc(TUint aSize);
+ TInt Dll::GlobalRead(TUint aPos,TDes8 &aDes);
+ TInt Dll::GlobalWrite(TUint aPos,TDesC8 &aDes);
+
+ Dll::GlobalAlloc() allocates the global data for the currently
+ running DLL. Specifying a size of 0 will free the data. The amount
+ of data allocated can be changed by calling Dll::GlobalAlloc()
+ repeatedly. It is normal to allocate the global data in the entry
+ point E32Dll() when a process attaches and when
+ Dll::GlobalAllocated() returns EFalse. There is no need to free
+ the data since if the DLL is unloaded the data will be freed. However
+ it is possible to use some of the allocated data to keep a reference
+ count which can be incremented on process attach and decremented on
+ process detach. When the count is zero it can be discarded.
+
+ Since the data is kept in the kernel the DLL cannot have direct
+ access to the data, so it must be read and written using the
+ Dll::GlobalRead() and Dll::GlobalWrite() functions. It
+ is considered a panic to write past the current size of the data
+ but not an error to read past the end of the data.
+
+ These functions are implemented in a class of their own since they
+ need to be statically linked with each DLL or EXE (note than an
+ EXE is also potentially a DLL) on the WINS platform.
+
+ Finally it is a good idea to minimize the size of the global data.
+
+ Look at the test DLL \e32\tcdt\t_dll.mak and the test program
+ \e32\tcdt\t_tdll.mak to see how this works in practice.
+
+9). Now release EXDLL??.PDB files. These come from EXDLL??.OBJ which is
+ a start up module for EWINS??.DLL, KWINS??.DLL and LWINS??.DLL which
+ have special initialisation requirements. These are just released as
+ an aide to debugging.
+
+NOTES
+=====
+
+It is now vital that programs are build with proper make files. In
+particular any program still linking to the C runtime library MSVCRT20.DLL
+will fail to start correctly. Note that we are only talking about the
+C runtime library and not the Win32 API libraries kernel32.lib,
+gdi32.lib, user32.lib etc. The C runtime library is no longer necessary
+as the base is now running entirely independently.
+
+All EXEs should be linked with ESTAT??.OBJ and should have _E32Startup
+set as the entry point.
+
+All DLLs should be linked with EDLL??.OBJ and should have _E32Dll set
+as the entry point. Remeber that a DLL must now supply a function
+E32Dll(). To see and example look at the code in \E32\DPWINS\WS_UTL.CPP.
+
+Everything should be linked with the user library EWINS??.LIB. Apart from
+other E32 software nothing else should be necessary.
+
+Make sure that "Ignore all default libraries" is set and that
+"Disable exception handling is also checked" and that alignment is
+set to 4 bytes.
+
+If you are not sure then start with one of the .MAK files released by
+the base and modify it to suit your project.
+
+Version 0.01.040
+================
+(Made by Colly, 20 July 1995)
+
+1). Converted the kernel to having a Kernel Supervisor Server and an
+ executive.
+2). Replaced the specific exit type of exception with a Panic() category
+ of Exception.
+3). Clean compiled all the platform independent source code with the GCC
+ compiler with the exception of the sources in UMATH.
+4). Added cleanup functionality to the kernel.
+5). Incorporated SteveT's fixes to pointer messages with the new screen
+ surround.
+6). Added Martin Dolphin's CArrayPacked classes. Renamed the classes
+ "Packed" to "Pak". His release notes follow:
+
+ This version of CArrayPak inherits from CArrayVar and uses
+ some virtual functions to achieve code reuse. TKeyArrayPak
+ inherits from TKeyArrayVar.
+
+ ucdt\uc_func.cpp
+ This has a slightly modified binary search.
+ This modification guarantees that:
+ //if no match is found.
+ //the index of the record logically following the value being searched
+ //for will be returned in aPos.
+
+ uadt\ua_array.cpp
+ Has the new CArrayPak code plus some other small
+ modification listed below.
+ CArrayFixBase::InsertIsq changed to reflect change in BinarySearch.
+ CArrayVarBase::Find, FindIsq have had unused length parameter
+ removed, some functions made virtual to achieve code reuse.
+8). Fixed further bugs in TInt64 divide and remainder functions as
+ reported by SteveT.
+9). Incorporated SteveT's changes to the region classes.
+10).Incorporated the faster versions of User::MemCopy(),User::MemFill()
+ and User::MemFillZ()
+11).Added two template inline functions to align pointers.
+ inline T *Align2(T *aPtr)
+ inline T *Align4(T *aPtr)
+ Align2 will make ((T *)&1)==0
+ Align4 will make ((T *)&3)==0
+ and two template functions to align integers.
+ inline TUint Align4(T aVal)
+ inline TUint Align2(T aVal)
+12).Removed the Notify() and SetNotify methods from RThread and RProcess.
+ They will re-appear in the file server in due course.
+13).Added the executive dispatcher to the kernel.
+14).Rationalised the RThread and RChunk read/write routines.
+15).Changed CActiveScheduler::Destroy() to just remove active objects
+ from the schedule queue. It used to destroy them as well. Before
+ removing each active object it will call CActive::Cancel();
+16).Fixed a bug in TLex8::NextToken() and TLex16::NextToken() which
+ was not checking properly for the end of the buffer. Found by Martin
+ Dolphin by trying to lex an empty command line.
+17).Changed the name of the key matching enumerates as follows:
+ TKeyArrayCmp to TKeyCmpText
+ TKeyArrayCmpNumeric to TKeyCmpNumeric
+ Added another constructor for comparing descriptors and changed
+ the order of the parameters as follows:
+ inline TKey(TUint anOffset,TKeyCmpText aType);
+ At anOffset should be one of the descriptor types, TPtr,TBufC etc
+ inline TKey(TUint anOffset,TKeyCmpText aType,TUint aLength);
+ At anOffset should be TText of length aLength.
+ inline TKey(TUint anOffset,TKeyCmpNumeric aType);
+ At anOffset should be an integer of some type.
+ Added support for TInt64s.
+ This change is propagated to the various TKeyArrayXXX:: classes.
+18).Fixed a race condition in the kernel when resuming threads.
+19).If a thread panics then it just quietly disappears. If this is
+ one of the server threads then the program appears to hang for
+ no reason. To this end I have added new services RThread::Server()
+ and RThread::SetServer(TBool aState). Any thread marking itself as
+ a server with RThread().SetServer(ETrue) will have its panics
+ reported through the messagebox and will then abort the program.
+ Note that this is done for the main thread as well.
+
+NOTES
+ All test programs pass in all builds.
+
+Version 0.01.039
+================
+(Made by Colly, 23 June 1995)
+
+1). Finally removed the dependency on the C runtime libarary.
+
+ There are new libraries in t:\msvc21\lib which should all
+ be copied to c:\msvc20\lib. This is still necessary as the
+ main operating system .DLL and SteveT's .DLL still link to
+ the runtime library MSVCRT20.DLL. Also copy
+ t:\msvc21\system32\*.* to c:\winnt35\system32\*.*
+
+ The build for a .EXE has now changed as follows:
+
+ a). Select project settings and highlight all 4 builds:
+ Select the Link tab and the Output category.
+ Set Entry-point symbol to _E32Startup
+ (The case is important in _E32Startup)
+ Select the general category.
+ Delete all the libraries/object modules.
+ Make sure "Ignore all Default libraries" is selected.
+ b). Select each build in turn and set the libraries/object modules
+ as follows:
+
+ Release : \e32sys\estat.obj \e32sys\ewins.lib
+ Debug : \e32sys\estatd.obj \e32sys\ewinsd.lib
+ Uni Release : \e32sys\estatu.obj \e32sys\ewinsu.lib
+ Uni Debug : \e32sys\estatud.obj \e32sys\ewinsud.lib
+
+ If in doubt look at one of the test programs.
+
+ The build for a .DLL which is linked to Win32 does not need to
+ change at all.
+
+ The build for a .DLL which is linked only to E32 must be changed
+ as follows:
+
+ a). Select project settings and highlight all 4 builds:
+ Select the Link tab and the Output category.
+ Set Entry-point symbol to _E32Dll
+ (The case is important in _E32Dll)
+ Select the general category.
+ Delete all the libraries/object modules.
+ Make sure "Ignore all Default libraries" is selected.
+ b). Select each build in turn and set the libraries/object modules
+ as follows:
+
+ Release : \e32sys\edll.obj \e32sys\ewins.lib
+ Debug : \e32sys\edlld.obj \e32sys\ewinsd.lib
+ Uni Release : \e32sys\edllu.obj \e32sys\ewinsu.lib
+ Uni Debug : \e32sys\edllud.obj \e32sys\ewinsud.lib
+
+ c). Provide a function prototyped as follows:
+
+ GLDEF_C TInt E32Dll(TDllReason aReason)
+
+ See \f32\sfsrv\fs_utl.cpp for an example of such a function.
+
+ The new system cannot be build with the project system at the
+ moment and must be built with the VC++ IDE. The correct build
+ order is as follows:
+
+ \e32\lsrc\lwins.mak
+ \e32\kpwins\ewins.mak
+ \e32\ustat\estat.mak
+ \e32\ustat\edll.mak
+
+2). Added the fancy graphics screen bitmap of protea to surround the screen.
+ It does not appear in its full glory on my work machine, but it does on
+ my home machine. Perhaps SteveT can sort this out for me. I am also
+ assuming that SteveT will handle the buttons on the imaghe and return
+ them as key strokes.
+3). CServer::RunL() was still using delete to remove a session when
+ a client disconnected rather than Destroy().
+4). Added a protected destructor to CBase which will stop any objects
+ derived from CBase being placed on the stack.
+5). Increased the Window servers stack to 1MByte.
+6). TInt64 divide was not working for large intergers.
+7). Absorbed SteveT's new region code.
+8). Fixed a bug in TLex::Val() which was not dealing with the end of the
+ descriptor properly. MartinH's fix.
+9). Added the TReal to buffer and buffer to TReal functions. The maths
+ library is now complete. Thanks to MartinH.
+10).Fixed a bug in CArrayFixBase::DestroyAll().
+11).Moved the TInt64 class from E32MATH.H to E32STD.H and its source
+ code from umath to ucdt.
+12).Took the additions to the bitmap allocator from JaneS
+13).New version of enter and leave which should fix previous problems
+
+NOTES
+=====
+
+1). T_LEX.CPP failed because the TReal functions now work. I have
+ commented these out until MH can fix them.
+2). T_THREAD.CPP and T_SEMUTX.CPP fail under the unicode debug version.
+ T_THREAD because their is a race condition in the kernel somwhere
+ and T_SEMUTX.CPP because there is a bug in the program logic. I will
+ fix these in the next release.
+
+Version 0.01.038
+================
+(Made by DavidW, 19 May 1995)
+
+One step backwards before taking two steps forward again!
+Put back RRegion::~RRegion to allow the Window Server and GDI to
+release new versions quickly, compatible with the latest E32, before
+they take more time over the next week to convert to a new RRegion
+scheme altogether.
+
+[Added later - fixed INCC.PRJ to release E32DES8.H & E32DES16.H]
+
+Also made a fix to MNT.CMD which meant that only the Release build
+versions were being released. The ESTAT*.PDB files weren't being
+released either.
+
+Note: T_I64 still fails in UON.
+T_SEMUTX fails intermittently (in either UON and UOFF).
+
+Version 0.01.037
+================
+(Made by Colly, 19 May 1995)
+
+1). Fixed a bug in Math::Rand().
+2). Moved the private classes TRectKey and TRectSwap in RRegion
+ to be declared locally in u_regn.cpp.
+ RRegion still has a virtual destructor which I have now removed. I
+ notice that the test code t_regn.cpp does not test either the Close()
+ or Destroy() functions.
+3). Re-organized the entire group.
+ SUSER has been split into
+ UCDT - User Concrete Data Types, platform independent
+ UPWINS - User Wins platform dependent
+ SOLIB renamed to UADT - User Abstract Data Types
+ SMATH renamed to UMATH
+ TUSER renamed to TCDT
+ TOLIB renamed to TADT
+ SKERN renamed to KSRC
+ SWINS renamed to KPWINS
+ SWINSD renamed to DPWINS
+ SLOCL renamed to LSRC
+4). In line with the above I have renamed E32OLIB.H and E32OLIB.INL
+ to E32ADT.H and E32ADT.INL.
+5). Added class CBitMapAllocator to Adt. This class uses a bitmap to
+ control allocation of resources. It is used by the PageAllocator
+ in the micro kernel to allocate free physical pages. Another
+ potential use is in implementing a block allocation scheme in
+ a binary file such as a BTree index file.
+6). I have changed the way the version numbers are formatted by TVersion.
+7). Fixed a bug in RSubSession::Close() which did not check for a NULL
+ handle before despatching the close message to the server. It is
+ normal practice to allow a close on something which has never been
+ opened/created.
+8). Recorded the size of components in the release history.
+9). The localising code is now released separately as LWINS.DLL. This
+ is currently included in the base release zip file ewins. Note that
+ only ewins.dll has a dependency on this file so that no build files
+ need change.
+10).Changed TDblQueIterBase::Wind() and TDblQueIterBase::Rewind()
+ to TDblQueIterBase::SetToFirst() and TDblQueIterBase::SetToLast()
+ Also added TDblQueIter<T>::Set(T &aLink) which will start the
+ iterator on a particular link.
+11).Changed TSglQueIterBase::Rewind() to TSglQueIterBase::SetToFirst()
+ Also added TSglQueIter<T>::Set(T &aLink) which will start the
+ iterator on a particular link.
+12).Added a function Adt::DestroyZ(CBase * &anObject) which will
+ destroy an object if anObject is not NULL and will then zero
+ anObject.
+13).Added DestroyAll() to CArrayFixFlat and CArrayFixSeg which
+ assumes that the array is a set of CBase pointers, i.e.
+ CArrayFixFlat<CBase *>. The only check that is made is the the
+ record length==sizeof(CBase *). Note that DestroyAll() destroys
+ all the non-NULL pointers and then calls the normal Destroy().
+14).Added a new template class TAggregate to e32atd.h. The idea
+ behind TAggregate is to automate the desctruction of aggregate
+ objects in CBase derived classes. Say you have three active
+ objects owned by your object CMyObject the current way of
+ writing the class is as follows:
+
+ class CMyObject : public CBase
+ {
+ public:
+ CMyObject();
+ virtual void Destroy();
+ inline CTimer &Timer(*iTimer);
+ inline CServer &Server(*iServer);
+ inline CComms &Comms(*iComms);
+ private:
+ CTimer *iTimer;
+ CServer *iServer;
+ CComms *iComms;
+ };
+
+ And the Destroy() is as follows:
+
+ void CMyObject::Destroy()
+ {
+
+ Adt::DestroyZ(iTimer);
+ Adt::DestroyZ(iServer);
+ Adt::DestroyZ(iComms);
+ CBase::Destroy();
+ };
+
+ With TAggregate you would do it as follows.
+
+ class CMyObject : public CBase
+ {
+ private:
+ enum {ETimer,EServer,EComms,EMaxAggregate};
+ public:
+ CMyObject();
+ virtual void Destroy();
+ inline CTimer &Timer(*((CTimer *)iAgg.iPtrs[ETimer]));
+ inline CServer &Server(*((CServer *)iAgg.iPtrs[EServer]));
+ inline CComms &Comms(*((CComms *)iAgg.iPtrs[EComms]));
+ private:
+ TAggregate iAgg[EMaxAggregate];
+ };
+
+ And the destructor is as follows:
+
+ void CMyObject::Destroy()
+ {
+
+ iAgg.Destroy();
+ CBase::Destroy();
+ };
+
+ If one of the aggregates is removed or another is added all that
+ has to be done is add a new enum and the accessor method.
+ The Destroy() will automatically be correct. Note that there is
+ no additional overhead for the iAgg.iPtrs[] in the accessors.
+15).I have added a new template class TAutoClose to e32std.h which
+ will add a destructor to any class which has a Close() method.
+ This is useful for functions in which you want to take advantage
+ of the compiler automatically destructing the object when it goes
+ out of scope. e.g.
+
+ TInt ReadFile(const TDesC &aFile)
+ //
+ // Read a file
+ //
+ {
+
+ TAutoClose<RFile> f;
+ TInt r=f.iObj.Open(aFile,KFileStreamText|EFileExclusive);
+ if (r!=KErrNone)
+ return(r);
+ TBuf_100 b;
+ if ((r=f.iObj.Read(b))!=KErrNone)
+ return(r);
+ .....
+ }
+
+ There is no need to call f.iObj.Close() as the compiler will do that
+ automatically when f goes out of scope. Even if the early return
+ after f.iObj.Read() is taken the compiler will still call
+ f.iObj.Close(). There is no overhead to using the TAutoClose class.
+16).Added SetMax() to TDes which set the length of the TDes to
+ MaxLength(). i.e. equivalent to:
+ TBuf_100 b;
+ b.SetLength(b.MaxLength());
+17).Added TPtrC::Set(const TText *aBuf,TUint aLength) and
+ TPtr::Set(TText *aBuf,TUint aLength,TUint aMaxLength)
+ since assignment of a TPtrC is not supported and assignment
+ of a TPtr means a deep copy rather than a shallow copy.
+18).Renamed the files E32DES8.INL and E32DES16.INL if E32DES8.H and
+ E32DES16.H
+
+Comp Date Bld .text .bss .rdata .data .idata Total
+===== ========= === ====== ====== ====== ====== ====== ======
+LWINS 17-Mar-95 37 822 32 1344 1092 268 2704
+EWINS 17-Mar-95 37 82484 560 6012 1156 2916 92568
+
+.text = The code size (a good indication)
+.bss = The uninitialized data size (a good indication)
+.rdata = The const data size (a good indication)
+.data = The initialized data size (a good indication)
+.idata = C++ initialisation + .DLL export table (unreliable indication)
+
+The .idata section is unreliable since it has all .dll refences by name.
+As .dll references will be by ordinal rather than by name I expect these
+sizes to fall quite a bit.
+
+Note that the current conversion factor from VC++ to GC++ is multiply
+by 1.16
+
+NOTES
+=====
+
+1). I think that all the heap debug macros in e32std.h should be prefixed
+ with __ and should be moved to their own include file e32hdbg.h which
+ is included by e32def.h. I also removed the unnecessary spaces in
+ their declaration which have been added back in build 035.
+2). The functions RHeapDebug() in the RHeap class look like constrcutors
+ which they are not. The should be declared as returning void and
+ should also be given a different name. There are a number of comments
+ in the RHeap class declaration which I have removed.
+3). T_thread.cpp fails. Also this program was including the header file
+ k32kern.h so that is could call Plat::CurrentProcess() to get the
+ current process. It is a bad idea for any test programs to call any
+ function in the kernel. This won't be possible on any other platform.
+ The correct way to get the current thread or the current process is
+ just to use an RProcess() or RThread() constructor. i.e.
+
+ if (RProcess().Mark())
+ etc.
+
+ if (RThread().Priority==EPriorityNormal)
+ RThread().SetPriority(EPriorityAboveNormal);
+
+ This works because the constructor for an RProcess or RThread sets
+ the RThread or RProcess handle to a special token which means the
+ currrent process or the current thread. It does no have to be
+ opened or created in the normal way.
+
+ Also the current process can be got from the current thread e.g.
+
+ RThread().Process()
+
+ P.S. This was covered in the release 26 release notes.
+4). T_HEAPDB.CPP also includes k32kern.h (now k32std.h) so that it
+ can call Kern::UserHeap(). This is unnecessary as there is
+ already a call User::Heap() which returns the current heap. I have
+ fixed the test program.
+5). T_I64.CPP still fails on divide. I will fix this in the next release.
+
+Version 0.01.036
+================
+(Made by MartinB, 11 May 1995)
+
+1) New SetThreadAllocFail method in User (MartinH).
+2) New macros in e32def.h (MartinH).
+3) New Math functions and test code (MartinH),
+4) New ASSERT_DEBUGs in RHeap::Alloc.
+5) Removed User::SetWSAllocFail, since cannot have window server
+ dependencies in the base.
+6) Improved region code (Lane).
+7) Added several "long ptr" qualifiers in P_I64.CPP. MSVC was
+ treating constants as 16 bit values when moved into (say)
+ [ebx]. (MartinB).
+
+All test code runs for ASCII DEBUG and UNICODE DEBUG builds (MartinB)
+(except T_I64 which does not run in UNICODE).
+
+Version 0.01.035
+================
+(Made by MartinB, 9 May 1995)
+
+1) Fix to Mul routine in P_I64.CPP.
+2) New region code from Steve/Lane.
+3) New T_THREAD test code from MartinH.
+4) New T_I64 test code from MartinH.
+
+All test code runs for ASCII DEBUG and UNICODE DEBUG builds (MartinB).
+
+Version 0.01.034
+================
+(Made by Colly, 9 May 1995)
+
+1). In both versions of RSessionBase::SendReceive() the parameter
+ TAny *aPtr can be passed as NULL.
+2). Converted the design E32 to make the categories Kernel, User and
+ Olib as units. This allows other designs to import these units.
+3). Added to RChannelBase overloads for DoRequest() and DoControl() which
+ allow none, one or two arguments.
+4). Added three functions to the TLex classes.
+ void SkipAndMark(TInt aNumber) which moves the mark along by aNumber.
+ TPtrC Remainder() which returns the remainder of the buffer after
+ the mark.
+ void Inc(TInt aNumber) which moves the pointer on by aNumber.
+5). Added IMPORT_C TAny *operator new(TUint aSize,TUint anExtraSize)
+ to CBase.
+6). I have removed the resource file stuff from Olib because I do not
+ want the base to have a dependency on the file system. Note that in
+ due course the file server like the window server will live in its own
+ group and is only included with E32 for convenience while I develop
+ it. The file server is already completely independent of the operating
+ system.
+ I suggest that we have two DLLs called something like HCILI and HCILU.
+ HCILI would contain user interface independent code and HCILU would
+ have user interface dependent code. Then a getbld can go something like
+ this:
+
+ GET E32 // The base
+ GET F32 // The file server
+ GET W32 // The window server
+ GET HCIL // Both HCIL DLLs
+
+ I originally intended to supply the base as 3 DLLs, i.e.
+ E32KERN.DLL,E32USER.DLL and E32OLIB.DLL I now intend to supply it as
+ just two merging E32OLIB.DLL and E32USER.DLL into E32USER.DLL. For
+ those who are fond of the name OLIB I am quite happy to relinquish
+ the name and HCILI.DLL could be OLIB.DLL. But OLIB is a funny name
+ as it stands for Object library which is strange since all libraries
+ are now object libraries. Maybe its time for OLIB to just disappear.
+7). In messages associated with a RSubSession the handle was being passed
+ in P1(). This was not the best option so I have now changed it to P4().
+ Note that for a SubSessionCreate message a descriptor is passed in P4()
+ rather than P1() which a server should use to write back the handle
+ of the sub session. See \e32\swinsd\ws_main.cpp for an example of the
+ approriate code.
+8). Added Math::Rand(TInt64 &aSeed). This returns a random number in the
+ range 0 to KMaxTInt (i.e. positive) and updates the seed.
+9). Renamed the operating systems Segment to Chunk to avoid confusion on
+ 80x86 platforms with segment registers. Thus RSegment has become
+ RChunk and User::SegmentHeap has become User::ChunkHeap.
+10). The function Test::Next() was assuming a zero terminated string. Fixed.
+11). RProcess::CommandLine() was not getting the full command line. Fixed.
+
+NOTES
+=====
+
+1). MartinB. Surely HufEncode should belong to class TDes and convert its
+ argument a TDesC into the TDes rather than belong to TDesC. As well
+ don't we need a second version of HufDecode called something like
+ HufDecodeInPlace which will do a decode in place on a TDes since
+ this is what the resource system does currently. Finally should we
+ not make a 32 bit version of the resource compiler.
+2). There is a #define test in E32TEST.H. All #defines should be in
+ upper case.
+3). Why does RRegion have a virtual destructor, a Close() and a
+ Destroy(). I suspect that the destructor should go.
+4). In TOLIB t_ctimer.cpp and t_cact.cpp both have a #include to
+ \e32\olib\o_std.h. This is not correct!
+5). In TUSER t_heapdb.cpp has a dependency on the window server header
+ file and in fact uses the window server. This is definitely
+ incorrect?
+6). Can everyone try and make an effort before releasing E32 that
+ all projects are left in the DEBUG build and that all test
+ programs do not have windows open and breakpoints left enabled.
+
+Version 0.01.033
+================
+(Made by MartinB, 4 May 1995)
+
+1) Changed jcxz to a jecxz in P_I64.CPP (!!!)
+2) Fixed some alloc heaven in CArrayVarBase::Delete.
+3) Improved T_RSC test code.
+4) Added MaxSize() to TDes.
+5) New RRegion code from Steve.
+6) Loads of test code from MartinH.
+7) Note u_heap.cpp temporarily includes <stdlib.h> (for
+ random number generators) for heap alloc failure testing.
+ This is a temporary measure until the real file handling an
+ random number generation becomes available.
+8) T_HEAPDB requires window server to run (since it tests for window
+ server heap failure).
+
+All test code runs for ASCII DEBUG and UNICODE DEBUG builds (MartinB).
+
+
+Version 0.01.032
+================
+(Made by MartinB, 26 April 1995)
+
+1) Added a new CResourceFile class (and its superclass CFile). CFile
+ uses standard C files as a temporary measure until Colly
+ releases the real filing system.
+2) Added a KErrFile const to go with the above. Again a temporary
+ measure.
+3) CResourceFile reads resource files produced using our resource
+ compiler. (S_.RSC and S_.RZC were used in the test code, and
+ form part of the release of the test code). Note that
+ CResourceFile also reads compressed resource files. This
+ meant that:
+4) Added Huffman compression for TDes16. Actually this does not
+ quite work yet, one or two of the test cases are #ifdefed out
+ in the UNICODE build. However it is 90% there and I have a
+ good idea of what the problem is (its to do with the unused
+ byte at the end when the descriptor compresses to an odd number of
+ bytes).
+5) New test code from MartinH.
+6) Minor fixes to threads from Colly/MartinH.
+
+NOTES
+=====
+
+1) Should we have a TDes::MaxSize() function?
+
+2) All test code runs for ASCII DEBUG and UNICODE DEBUG builds, except
+ T_RSC does not run in UNICODE.
+
+
+Version 0.01.031
+================
+(Made by Colly, 18 April 1995)
+
+1). Changed KEventPending to KRequestPending.
+2). Made CActiveScheduler::Start() call the virtual function
+ WaitForAnyRequest().
+3). Fixed ..\rel\ewinsdb.prj to release the estat*.pdb files
+ rather that wwins*.pdb files.
+4). When a thread had an exception or was killed, terminated or
+ panicked, execution unfortunately continued. Fixed.
+5). Added a function User::Dying() which is called by all the kernel
+ functions just before they kill,terminate,except or panic a thread
+ or process. This is a very good place for a breakpoint when
+ debugging. It will catch everything.
+6). Added support to dynamically load a DLL and then lookup functions
+ in the DLL. See class RLibrary.
+7). Added support for device drivers. See User::LoadDevice() and
+ User::FreeDevice() as well as the example device driver in
+ \e32\swinsd\d_timer.mak and its test program \e32\swinsd\t_devc.mak.
+8). Added a constructor to all TFindHandle derived classes to allow
+ initialisation with the find string.
+9). Converted the rose designs to rose 2.525
+
+NOTES
+=====
+
+1). The fact that CActiveScheduler::Start() is static is no reason why
+ the virtual function WaitForAnyRequest() cannot be called. Just use
+ the static pointer to the scheduler:
+ theActiveScheduler->WaitForAnyRequest()
+
+All test code runs for ASCII DEBUG and UNICODE DEBUG builds (MartinB).
+
+
+Version 0.01.030
+================
+(Made by Colly, 12 April 1995)
+
+1). Removed the virtual destructor in CBase. Added vitrual void Destroy().
+ CBase::Destroy() now calls delete this. It is now generally necessary
+ to call the base classes Destroy() in order to get proper destruction
+ of the object. Note that the DeleteAll methods in TDblQue and TSglQue
+ only work if the objects on the queue are derived from CBase. Added
+ a static function Olib::Destroy(CBase *anObject) which will only
+ destroy the object if anObject is not NULL.
+2). Added a static function:
+ CActiveScheduler * CActiveScheduler::Current();
+ which return the currently installed active scheduler.
+3). In RSubSession::CreateSubSession() was not passing as P1() in the
+ message the address of the reply so that the subsession handle could
+ be returned by the server.
+4). Creating a semaphore with an initial count other than 0 did not set
+ the internal count with the initial count although the Windows/NT
+ semaphore was being set correctly. The same bug applied to Mutexes.
+5). When a process was dying its access count was not being decremented
+ so that if no handles were outstanding the object was not being
+ destroyed.
+6). CObjectIx::Add() and CObjectCon::Add() were closing the object being
+ added if the add failed. This proves to be unhelpful so they have
+ been changed to just fail and not do the close.
+7). Added the following functions to RThread and RProcess to determine
+ the reason a thread or process exited.
+ IMPORT_C TExitType ExitType() const;
+ IMPORT_C TInt ExitReason() const;
+ IMPORT_C TName ExitCategory() const;
+8). The design of the CPeriodic class made it unusable. This has now been
+ changed so that the New functions add the active object to the
+ scheduler. Start() is now defined as:
+
+ void Start(TInt aDelay,TInt anInterval,
+ TPeriodicCallBack aCallBack,TAny *aPtr);
+
+ which allows a CPeriodic to be restarted after it has been cancelled.
+ StartL() has been dropped since Start() is void.
+ There was also a bug in the RunL() method in that it issued the callback
+ and then requested the next timer. It should request the next timer and
+ then issue the callback.
+
+The following merged in by MartinB:
+
+9) Removed double definition of TText8 and TText16 form e32def.h
+10) Moved enclosing #endif (matched to #if !defined(__E32DEF_H__)) to
+ end of e32def.h.
+11) Changed make files so that .PDB files are built into \e32sys.
+12) Added virtual WaitForAnyRequest to CActiveScheduler. This is not
+ called from Start, however, since Start is a static function.
+ After discussion with DW I retained User::WaitForAnyRequest
+ in Start, until we have time to discuss which functions
+ should be static.
+13) Changed KErrPending to KEventPending.
+
+
+Version 0.01.029
+================
+(Made by Martin, 3 April 1995)
+
+1) New alloc testing code does not include filename and lineno
+ (MartinH).
+2) New SglQue test code (DougF).
+3) New test code (JalP).
+4) Move common functionality of TKeyArrayFix and TKeyArrayVar into
+ TKey (JalP).
+5) Fix to TEnter (DavidW).
+
+All test code runs for ASCII DEBUG and UNICODE DEBUG builds.
+
+
+Version 0.01.028
+================
+(Made by Colly, 22 Mar 1995)
+
+1). Definitely the last name changes for the descriptor and buffer classes.
+ Old Name New Name
+ ======== ========
+ TDesC TDesC
+ TDes TDes
+ TBufBase TBufCBase
+ TBuf TBufC
+ HBuf HBufC
+ TDesR TPtrC
+ TDesW TPtr
+ TBufW TBuf
+
+ Note that the function:
+ TDesW DesW()
+ in TBufBase has now been renamed:
+ TPtr Des()
+ Its helpful to consult the Rose class diagram to see why these names
+ are sensible.
+2). Took Steve's new region code.
+3). Added the missing #defines for __TEST_INVARIANT.
+4). Changed the graphics window to position to 10,10.
+5). Fixed the re-entrancy bug with UserWindowServer::Request().
+6). Added the fix to stop the beep on ALT + char.
+7). Added the code for User::Abort() and User::Exit().
+8). User::Panic() was panicking the process and not the current thread
+ making it impossible to run test threads to see if they panic.
+
+ All the test code passes under the DEBUG build.
+
+NOTES
+
+1). The virtual destructor in CActive is calling the virtual DoCancel
+ which since the destructor is running at the CActive level has
+ no method to call as its pure virtual. The only reasonable solution
+ is to introduce a virtual Destroy() function to CBase() which can
+ do the necessary cleanup and then do the delete.
+2). Many of the test programs do not have a standard comment header.
+ One did not even have a header. This is just careless.
+ I have fixed them all.
+3). Many people when declaring an enum leave a comma on the last
+ declaration which is untidy.
+4). A number of people are decalring automatic variables with capital
+ letters. Please avoid this practice.
+
+
+Version 0.01.027
+================
+(Made by Martin, 16 Mar 1995)
+
+1) Changed TBuf to TBufW, TLcb to TBuf and TLcbH to HBuf.
+2) Fixed .lnk files so test code works if built from command line
+ (Duncan).
+3) New T_REF test code (Jal).
+4) Added previously missing RRef<T>::AllocL to e32std.inl (Jal).
+5) Fixed bug in RRefBase::DoAlloc (Jal).
+6) Added invariant to TDateTime (Gill).
+7) Improved T_DATE test code (Gill).
+8) Improved T_KEY test code (MartinH).
+9) Fix to heap checking code (MartinH).
+10) Changed T_QUE to use V classes (rather than S classes) (Doug).
+11) Made iInterval protected (was private) in CPeriodic (at Steve's
+ request).
+12) This release contains a zip file release (in s:\e32\zip) so that
+ users should not need to build E32. Only the ASCII DEBUG
+ version has been released.
+
+All test code (ASCII DEBUG) can now be built and run from the command line
+(except T_HEAPDB).
+
+Actions:
+
+1) Now that C classes rely on zero filling for initialisation their
+ definitions MUST be changed so that they cannot be declared on the
+ stack.
+2) MartinH to fix T_HEAPDB.
+3) Steve to complete transformation of CRegion to RRegion.
+4) MartinB to complete (or remove) Huffman encoding (did not have
+ time to do it this release).
+5) T_ARRAY and T_VARRAY need more test.Start() and test.Next()
+ messages (Jal).
+6) Many classes still have no __TestInvariant methods (All).
+7) CBufSeg has a test class defined under #if defined(_DEBUG) (Jal).
+
+
+Version 0.01.026
+================
+(Made by Colly, 11 Mar 1995)
+
+1). Added an operator new() to class CBase which fills memory with zeroes
+ so that most constructors need do nothing. Note that a constructor
+ is still required in order to set the name of the class in debug
+ builds.
+2). Changed the RProcess::FileName() and RProcess::CommandLine() functions
+ to return their result rather than take an them as reference args.
+3). Added RHandleBase::Duplicate(RProcess aSrc) which allows a handle from
+ another process to be duplicated in the current process. This is also
+ the mechanism by which the pseudo handles for the current thread and
+ the current process to be turned into real handles. i.e.
+
+ RThread self;
+ self.Duplicate(RProcess());
+
+ Note that you will now need to call self.Close() at some stage since
+ the resource must be freed.
+
+ In case you have missed the examples in ..\tuser\t_kern.cpp
+ instantiating a RThread or RProcess by default give handles to the
+ current thread and current process respectively. i.e.
+
+ RThread().Name() will return the current threads name.
+
+ These objects use a pseudo handle since it is not possible to close
+ these handles since if you could close them they would have to
+ delete the current thread or current process. Since these are pseudo
+ handles passing them to another process will not work as in the other
+ process they will also mean the current process and current thread.
+ Duplicate overcomes this problem since it gives a real handle to
+ either the current thread or the current process.
+4). Added the RThread::Logon(),RThread::LogonCancel(),RProcess::Logon()
+ and RProcess::LogonCancel() functions.
+5). Cleanup on Thread termination by the kernel now implemented.
+6). RThread::Kill(),RThread::Exit(),RProcess::Kill() and RProcess::Exit()
+ implemented fully.
+7). Changed Plat::Panic() and Plat::Fault() to always use the desktop
+ window for the messagebox.
+8). Changed to build options for all variants. Everyone should make a new
+ .MAK file from T_KERN.MAK as a prototype. Presumably the tool sets
+ will have to be updated to reflect these changes. Also fixed a number
+ of link failures which had crept into the system.
+9). Note that because of the use User::SetVaArgList() the optimisation
+ in the release versions to drop stack frames cannot be used.
+10). The definition of the private class TLink in CBufSeg is a waste
+ of space in the headers. So I have declared a forward reference
+ to the class TBufSegLink and then only need the actual declaration
+ and implementation in O_BUF.CPP.
+
+The following merged in by MartinB:
+
+11) Uses new toolsets (use TOOLS WINS and TOOLS WINSD to get them).
+12) New T_DES test code. (From Duncan).
+13) Fixed integer compares in TKeyArrayFix and TKeyArrayVar. (From
+ Jal).
+14) Fixed bug in CArrayFixBase::InsertISQ. (From Jal).
+15) Added classes: TSglQueLink, TSglQueBase, TSglQue, TSglQueIterBase
+ and TSglQueIter. (From Colly). (No test code yet).
+16) Added classes: RRefBase and RRef. (From Colly). (No test code
+ yet).
+17) Added Alloc functions that take a size parameter to RRef classes
+ (at Jal's request).
+18) Added __TEST_INVARIANT macro to e32std.h. (from MartinH).
+19) Added MartinH's heap checking code. Note took some functions
+ even though they were not commented - they will be commented for next
+ release.
+20) Took keycode code from DavidB. NOTE: P_STDKEY.CPP still contains
+ some numbers that should be converted to symbolic constants.
+21) Small changes to code in winsd from Steve.
+22) Changed User::MemSwap in u_func.cpp so that it does not swap if
+ memory locations are identical. There is an argument to do
+ this in the compare routines as well.
+23) Moved region to e32std.h and called it RRegion. Steve will implement it as
+ a proper 'R' in a subsequent release.
+
+ASCII Debug version only was tested.
+
+All test code passes except T_QUE which fails on DeleteAll. Note
+that
+
+T_HEAPDB, T_ARRAY, T_CACT, T_VARRAY fail when built from the command
+line.
+
+Version 0.01.025
+================
+(Made by MartinB, 7 Mar 1995)
+
+1) From Gillian: New TDateTime code.
+ Changed DateAsString() to Format().
+ Removed 3 unnecessary Add() functions.
+ Ammended t_time.cpp test code.
+ Renamed u_time.cpp to u_date.cpp (to lessen confusion with
+ timer code).
+2) From Jal: Bug fix in CBufSeg::Delete() method. New test code.
+3) From Duncan: mnt.cmd altered to build math functions and test code.
+4) From Duncan: Updated all .lnk files for test code, so that they are built as
+ windows rather than console applications.
+5) From Duncan: Introduced bld.prj in SMATH: this contains all the buildable math
+ routines (there are some .cpp files in li.prj that have not yet
+ been converted to E32).
+6) From Duncan: Introduced bld.prj in SWINSD: this contains all the buildable cpp
+ files (there are some .cpp files in li.prj that have not yet
+ been converted to E32).
+7) From Doug: Removed DEBUG friend declarations from Que classes.
+8) From Jal: New CRefCountBase and CRefCount classes added to Olib.
+9) From MartinH: New TKeyArrayCmpNumeric comparision types for
+ TKeyArrays. Ammended T_KEY test code.
+10) From MartinH: Ammended T_ACT test code.
+11) From DavidW: new T_VERSION test code.
+12) Minor fixes to test code.
+
+All ASCII DEBUG test code runs. There is one anomally: T_COBJ runs
+fine if build inside VC++ but panics with a user panic of 37 if built
+from the command line. It was getting late so I decided not to track
+this one down.
+
+Version 0.01.024
+================
+(Made by Colly, 1 Mar 1995)
+
+1). Renamed TPackage to TPckgBuf which packages an object in a TBuf8 and
+ added TPckgC which packages in a TDesR8 and TPckg which packages in
+ a TDesW8.
+2). Added new Panic function to RMessage which panics the client and
+ frees the message as well as one to CSession which just panics the
+ client. This is necessary as the Client() functions return a const
+ RThread & on which Panic cannot be called.
+3). Noticed that Convert(const TDesC &aDes,...) would not work properly
+ as taking the address of aDes on the stack would fail. Changed to
+ use the User::SetVaArgList() function. Also removed the version
+ of Convert which took a string as an argument. Fixed the test
+ code accordingly.
+4). My code in the example window server client side code was being very
+ naughty and assuming that all arguments were being passed on the
+ stack (TRUE for VC++, but not TRUE for GCC ARM code generation). Fixed.
+5). Removed the function numbers from the RWindowServerBase class as
+ they can be entirely private.
+6). The platform code to get system time was not subtracting 1 from the
+ day so TDateTime was correctly panicking the kernel on 28 Feb since
+ it was trying 29 Feb.
+
+Version 0.01.023
+================
+(Made by Colly, 27 Feb 1995)
+
+1). Moved the region code to SUSER in the file U_REGN.CPP. Moved the
+ test code from TOLIB to TUSER.
+2). The OLIB CServer class was deleting the server object on disconnect
+ rather than the CSession. Fixed some other bugs as well.
+3). Renamed CActive::Run() to CActive::RunL() to indicate that it may
+ leave.
+4). Renamed CServer::Service() to CServer::ServiceL() to indicate that
+ it may leave.
+5). Renamed CServer::NewSession() to CServer::NewSessionL() to indicate
+ that it may leave.
+6). Added the TInt64 class and a number of the maths functions. See
+ \e32\inc\e32math.h.
+7). Completely changed the whole scheme for E32 programs from being
+ console based to being GUI based. Test programs will write to
+ a normal Windows/NT console and the GUI window will be ignored.
+ All GUI programs now need to link with a window server library,
+ i.e. one of wwins,wwinsd,wwinsu,wwinsud. See the make file in
+ \e32\tuser\t_gui.mak.
+ A basic window server which just provides console services can be
+ found in swinsd in the project wwins.mak until Steve can get his
+ window server running.
+ All programs now use:
+ GLDEF_C TInt E32Main()
+ for the main program instead of main().
+ The functions for the basic window server and console are in header
+ \e32\inc\e32wsrv.h. Steve will provide these and extended functions
+ by subclassing these in his Window server library.
+8). Added a variant to RThread::Read() which allows an offset to be
+ specified withing the descriptor to allow reading in smaller chunks
+ in case the user sends over a huge chunk of data.
+9). Added the TEvent class and various functions all of which are
+ only for a Window server. I will discuss these with Steve directly.
+ The data is in \e32\inc\e32evnt.h.
+10). The CArray classes were leaving in their constructors. Fixed by
+ delaying allocation of the CBufBase till an insert. Increased
+ the error checking.
+11). The kernel was not doing unicode properly since UNICODE was
+ not defined in \e32\swins\p_std.h before windows.h was included.
+12). Added TDes8::Copy(const TDesC16 &aRef) and
+ TDes16::Copy(const TDesC8 &aBuf) conversions between 8 and 16.
+
+ Notes:
+
+ Many of the test programs were not keeping test.Start() and
+ test.End() in balance.
+ In U_TIME.CPP the unicode build was disabled because Gillian
+ was using a TLex8 instead of a plain TLex8. I also not that
+ the API for DateAsString takes the format string as a pointer
+ and not as a reference. Also the name of the function should
+ surely be Format().
+
+Version 0.01.022
+================
+(Made by Martin, 17 Feb 1995)
+
+1) Fixed construction of TLex over strings.
+2) New time class from Gillian.
+3) Fixed t_buf,t_bflat and t_bseg test code from Jal.
+4) Fixed t_lex test code from MartinH.
+5) Changed CRegion to RRegion (after consultation with Steve).
+6) NOTE: the TDateTime::DateAsString function fails to build under
+ unicode.
+7) K_MES.CPP does not build under UNICODE, search for !!! string to
+ find where.
+
+Note that there are new wins and winsd toolsets and a new version of
+EPR. Get these by doing
+ TOOLS WINS
+ TOOLS WINSD
+in the usual way.
+
+Version 0.01.021
+================
+(Made by Colly, 16 Feb 1995)
+
+1). In TUSER t_buf,t_lex do not compile.
+2). In TOLIB t_bflat,t_bseg do not compile.
+3). In TOLIB t_cact,t_cobj compile but fail. Note t_cact was t_creq.
+4). Made the kernel platform function Plat::SetVaArgList(VA_LIST &aList)
+ public in class User. This function was written assuming the argument
+ const TDesC &aFmt was the first argument. Using it in
+ Test::Panic(TInt anError,const TDesC &aFmt
+ would not work correctly. Changed this function to take a second
+ argument which says how many bytes to skip before the
+ const TDesC &aFmt argument. For Test::Panic this is 4 and 0
+ for all other uses.
+5). Renamed CRequester to CActive and CRequestManager to CActiveScheduler.
+6). Renamed all T classes which require closing to free their resources
+ to R classes. I have not renamed CRegion to RRegion in this release
+ but would propose that we do this (Steve?).
+7). Added User::At() and User::After() to put the current process to
+ sleep for relative and absolute time repectively. These are sync
+ functions.
+8). Implemented the RMessage, RServer and RSessionBase classes and added
+ the Olib classes CServer and CSession. See the T_SVR.CPP test code
+ to see how these are used.
+9). Renamed t_req.* in TOLIB to t_act.*
+10). Added the template class TPackage<T> which will package any type
+ T in a TBuf<sizeof(T)>. Note the -> and () operator overloading.
+
+ TPackage<TVersion> v;
+ v->iMajor
+ v().iMajor
+
+ This is most useful for passing and receiving non TDesC arguments
+ to a server so that the server can subsequently read/write to it.
+11). Added the minimum,maximum values for all integers in e32std.h look
+ for KMaxTInt8 etc.
+
+Queries
+-------
+
+1). Are we going to implement a 16 bit version of Hufman coding. If not
+ then we cannot have this functionality as there cannot be a difference
+ between 8 and 16 bit character versions as far as functionality goes.
+2). Someone put #ifdef UNICODE into one of the files in swins. This is
+ wrong and should have been #if defined(_UNICODE). Although Microsoft
+ are confused we should always use the _UNICODE form.
+3). I think we should rename User::Check and User::Available to have
+ Heap in their name somewhere.
+
+Version 0.01.020
+================
+(Made by MartinB, 15 Feb 1995)
+
+1) Removed (most) string functions from descriptors.
+2) Fixed bug in unicode Printf.
+3) Time class changed to DateTime.
+4) Made some queue parameters constant.
+5) Tidied up some of the Locale code.
+6) Tidied up mnt.bat and renamed it to mnt.cmd.
+7) Fixed Format for %S in descriptors.
+8) Added Huffman coding to TDesC8 (finally).
+9) Added some DateTime validation routines.
+10) Removed SetActive and SetInActive functions from CRequestors.
+11) Fixed most test code to run with the new descriptors, but there
+was too much to do for some (ie t_buf, t_lex, t_bflat).
+
+Version 0.01.019
+================
+(Made by Colly, 7 Feb 1995)
+
+1). Added the new TTimer concrete data type (CDT).
+2). Added the OLIB classes CRequestManager and CRequester.
+3). Added the OLIB requesters CTimer and CPeriodic.
+4). UNICODE needs to be defined as well as _UNICODE.
+5). Fixed a bug in TDblQueIter where neither the inc or dec operators
+ returned NULL at the end of the queue. Changed the test code to deal
+ with this. Note that if the iterator is positioned at the end of the
+ queue it will also return NULL when being casted.
+6). Fixed a bug in the TDes::Format(const TDesC &aDes) functons which
+ when try to set up the VA_LIST were taking the address of aDes and
+ getting it rather than the expected address of the argument on the
+ stack. Fixed by using the new User::SetVaArgList() function. The
+ test code is not testing this part of the code.
+7). Added the new static time validation functions to User.
+8). The User::WaitForRequest() type functions are now operational.
+9). Added the device driver code. Still to write a test device driver
+ but this will probably be a console device.
+10). Changed all the kernel classes to be D something rather than C
+ something to avoid name clashes with OLIB.
+11). Changed the CObject class to allocate the name of the resource so
+ that NULL can be used to indicate an unnamed object. This has
+ changed the API's for some of the CreateLocal functions to no
+ longer require a name, i.e. TSemaphore::CreateLocal().
+12). Changed all the API's to the kernel to use const TDesC& rather
+ than const TName& etc.
+13). All tests pass in non-unicode debug.
+
+Version 0.01.018
+================
+(Made by MartinB, 3 Feb 1995)
+
+1) Improvements to MartinH's test code.
+2) Uses new format link files (so needs new tools release).
+3) Incorporates Duncan's test code.
+4) Improvements to Strings in test code (ie _TL macro).
+5) Removed most of the #if defined(_DEBUG) stuff from include files,
+ but not for the friend classes. Working on a plan for this though.
+6) Fixed T_VARRAY .MAK file (was building T_ARRAY).
+7) This is a consolidation release.
+
+Version 0.01.017
+================
+(Made by Colly, 26 Jan 1995)
+
+1) Integrated the changes in preparation for device drivers.
+2) Note that the #if defined(_DEBUG) stuff for queues in the
+ headers is unacceptable.
+3) Note that I am not confident of the enumerate for EAllowDuplicates
+ nor the provision of default parameters.
+
+Version 0.01.016
+================
+(Made by MartinB, 24 Jan 1995)
+All test code passes. (But have not tried UNICODE build).
+
+Now builds with 32bit EBLD. To get this type
+
+TOOLS ETSET
+TOOLS WINS
+TOOLS WINSD
+
+You can then do MNT BLD etc from the command line.
+
+1) Added _S macro and changed _L macro in preparation for removing
+ strings from descriptors. Changed code to use _S and _L so that
+ strings could be easily removed in next release.
+2) Took T_TKEY test code from MartinH.
+3) Removed Free from CBuf class.
+4) Minor bug fixes here and there.
+5) Took Que code from Douglas
+
+Version 0.01.015
+================
+(Made by Colly, 18 Jan 1995)
+
+1). Made the final re-organisation to the descriptors and introduced
+ the new derived class TDesR. Note that TDesC and TDes are real
+ abstract base classes as they cannot be directly instantiated.
+ (They have no contructors). Note that functions like Mid(),Left()
+ etc. now return a TDesR.
+
+ Added the template TLcb class. This class is intended for use
+ as a member of a struct or class since it needs the minimum
+ storage space.
+
+ This is similar to the TBuf class except that it is a length
+ followed by the buffer, i.e. no max length. Thus apart from
+ assigning to it and behaving as a TDesC a TLcb cannot be
+ manipulated as it was a TDes. However help is at hand since there
+ is a function DesW() which return a writeable descriptor through
+ which a TLcb can be manipulated in the same was as a TBuf. i.e.
+
+ TLcb<KMaxName> b;
+ b=_L(" Some spaces");
+ b.TrimLeft(); // This will fail.
+ b.DesW().TrimLeft(); // This will work fine.
+ b.DesW().UpperCase();
+
+ If a lot of write operations are to be performed on the TLcb then
+ it is more efficient to take a copy of the TDesW. i.e.
+
+ TDesW w=a.DesW();
+
+ Note that there is no public constructor on TDesW for a TLcb
+ directly as it would need you to pass the maximum length as well
+ which is best left to the template to do on your behalf.
+
+ If a function needs a writeable descriptor then just pass b.DesW()
+ and all will be well.
+
+ As a last final thing for descriptors I have added one final class
+ TLcbH (H stands for heap). A TLcbH has the property that the TDesW
+ returned by DesW() has its iMaxLength set to the size of the alloc
+ cell - sizeof(TUint). A fine feature of this is that the length of
+ an alloc cell which is always present can now be used to good
+ purpose. It is also possible to call the TLcbH member functions
+ ReAlloc() or ReAllocL() on the cell and the get another TDesW
+ which will have changed its iMaxLength to the new size of the cell.
+
+ TLcbH *TLcbH::ReAlloc(); // Returns NULL if fails
+ TLcbH *TLcbH::ReAllocL(); // Leaves if fails
+
+ It is possible to directly construct a TLcbH with the static
+ functions:
+
+ TLcbH *TLcbH::New(TUint aMaxLength) // Returns NULL if fails
+ TLcbH *TLcbH::NewL(TUint aMaxLength) // Leaves if fails
+
+ The TDesC class also has two methods:
+
+ TLcbH *TDesC::Alloc(); // Returns NULL if fails
+ TLcbH *TDesC::AllocL(); // Leaves if fails
+
+ which will clone the descriptor on the heap. The size of the TLcbH
+ will be the length of the descriptor. Remember that these objects
+ must be freed with either delete or User::Free().
+
+ Note that there is a class TLcbBase which is just used to provide a
+ place to provide the code for the template class and although this
+ could be placed in the TDesC class this could only be done by
+ sacrificing the efficiency of the constructors for the TLcb class.
+ TDesC has so many constructors that TLcbBase is useful in providing a
+ selector for the base constructor. If this was removed an artificial
+ enum would have to be added to the constructors in TDesC to ease
+ selection. Since these are called inline by TLcb this would waste
+ code.
+
+ It is useful to look at the Rose class diagram in \e32\desn\e32.dsn
+ in the User\Descriptors category.
+
+2). Took the fixed u_time.cpp and new t_time.cpp.
+
+3). Changed the build plan so that all 4 build versions are supported
+ in all E32 .MAK files and that all releaseable files are in \e32sys
+ as follows:
+
+ Build Name Object directory
+ ========== ================
+ Win32 Release \work\e32\wins\rel
+ Win32 Debug \work\e32\wins\deb
+ Win32 Uni Release \work\e32\wins\urel
+ Win32 Uni Debug \work\e32\wins\udeb
+
+ Build Name .DLLs
+ ========== ================
+ Win32 Release \e32sys\ewins.dll
+ Win32 Debug \e32sys\ewinsd.dll
+ Win32 Uni Release \e32sys\ewinsu.dll
+ Win32 Uni Debug \e32sys\ewinsud.dll
+
+ Build Name .LIBs
+ ========== =====================================
+ Win32 Release \e32sys\ewins.lib \e32sys\estat.lib
+ Win32 Debug \e32sys\ewinsd.lib \e32sys\estatd.lib
+ Win32 Uni Release \e32sys\ewinsu.lib \e32sys\estatu.lib
+ Win32 Uni Debug \e32sys\ewinsud.lib \e32sys\estatud.lib
+
+ The directory \e32\lib has been deleted and replaced with
+ \e32\rel where the release project files are kept.
+
+ As a result of this no generated files get placed in the \e32
+ source tree, meaning a check -a li should always show no
+ additional or missing files
+
+4). Fixed most of the death in the unicode build but some test
+ programs are not building properly.
+
+5). Added the __DECLARE_TEST() macro for adding the test operations
+ to classes for debug builds. This macro should always be declared
+ as the last thing in the class as it switches back to public: as
+ follows:
+
+ public:
+ void __TestInvariant() const;
+ void __Test() const;
+
+ If a DLL is being built the __DLL__ #define should be present and the
+ macro will generate:
+
+ IMPORT_C void __TestInvariant() const;
+
+ The operation __TestInvariant() is expected to be supplied for all
+ classes and should do all the checking that it can to determine that
+ the object is in a healthy state. If it finds an error it should call
+ User::Invariant() which will cause a panic. If a class is derived from
+ a base class then the base class __TestInvariant() should be called
+ first and then further checking should be done.
+
+ This macro should not be added to template functions as the base class
+ from which the template function is derived should be able to do all
+ the necessary checking.
+
+ The __Test() function is not implemented and is provided to allow
+ test code a way of directly accessing all the members of a class.
+ Test code needs only to provide the function and then call it as it
+ is always assumed to be in the same .exe as the calling program.
+
+ Look at e32des8.inl and \e32\suser\u_des8.cpp for an example of how
+ to implement __DECLARE_TEST().
+
+ N.B.
+ It is expected that all classes will implement this scheme.
+
+6). Taken Gillian's fix to u_loc.cpp which was returning day names
+ for months.
+
+Version 0.01.014
+================
+(Made by Colly, 16 Jan 1995)
+1). THeap::Available() was not subtracting the header from the cells size.
+2). The insert bug in CBufSeg has been fixed.
+3). Implemented the new TDes/TBuf plan. This now allows TBufs to be moved
+ around in memory so that CArray<TBuf_40> is now O.K. Note that TDes8
+ cannot be instantiated, instead instantiate a TDesW8. TBufs now only
+ have an overhead of 8 bytes. See TDesC8::Ptr() to understand how
+ this trickery is accomplished. In general note that the values of the
+ members of TDesC8 and its derived classes are now meaningless so don't
+ jump to conclusions. The iLength should be divided by 4 to get the
+ real length. The bottom two bits provide flags for the Ptr() function.
+ For TDes8,TBuf8 and TDesW8 iPtr is in fact the maximum length. The
+ address of the buffer for TBuf8 is assumed to follow iPtr. For a
+ TDesW8 the real pointer to the buffer follows iPtr.
+4). Added the TVersion class and the User::Version() function.
+5). In class TLex, renamed Token() to NextToken() and made
+ MarkedToken() and NextToken() return a TDesC8.
+6). Removed the new operator in class CBase. As the cell is no longer
+ zero filled all relevant fields must be initialised.
+7). Added a member variable TText *__iName to CBase when the _DEBUG
+ flag is set. All constructors of classed derived from CBase should
+ initialise by using the __DECLARE_NAME macro. For CBufSeg this would
+ be :
+ EXPORT_C CBufSeg::CBufSeg(TUint anExpandSize)
+ //
+ // Constructor
+ //
+ : CBufBase(anExpandSize),iSeg(NULL)
+ {
+
+ __DECLARE_NAME(_L("CBufSeg"));
+ }
+8). Changed the ASSERT1,ASSERT2 and ASSERT3 macros to
+ __ASSERT_ALWAYS - applied in all builds
+ __ASSERT_DEBUG - applied only in debug builds
+ __ASSERT_OPT - applied if __OPT__ is defined
+ The previous versions assumed that Panic was called, i.e.
+ #define ASSERT1(c,p) if (!(c)) Panic(p)
+ This has been changed to allow other functions to be called.
+ #define __ASSERT_ALWAYS(c,p) if (!(c)) p
+ This should be used as follows:
+ __ASSERT_ALWAYS(anIndex<iLength,Panic(EDes8IndexOutOfRange));
+9). Further bugs showed up in T_BFLAT which was still assuming that
+ a TBuf was zero terminated. Changed the code to zero terminate
+ after construction.
+
+Version 0.01.013
+================
+(Made by Colly, 12 Jan 1995)
+1). Completed the implementation of the descriptor/buffer classes.
+2). The TLocale class is now working.
+3). Move SDate,STime and SDaySecs out of TTime. Made the members
+ start with a lower case. Changed the order of members so that
+ sorting will occur correctly. Changed the filler on STime to be
+ 1/100ths of a second. Provided a service in the kernel to retrieve
+ the current 1/100ths.
+4). Changed TTime to call the kernel to get the current time and TLocale
+ to get the start of week. The function to set system time is in
+ User. i.e. User::SetSystemTime(TSystemTime aTime);
+5). Moved the static functions from TTime to User.
+6). Converted the u_time.cpp to E32 code standards.
+7). Converted the u_graph.cpp to E32 code standards.
+8). Converted the o_region.cpp to E32 code standards.
+9). Fixed the bug if you ran a program from the command line without
+ the .exe.
+10). Changed TDblQue::Next() to be TDblQue::First() and
+ TDblQue()::Prev() to be TDblQue()::Last(). Changed the
+ implementation of AddFirst() and AddLast() to take a T * rather
+ that a TDblQueLink *.
+11). Changed the static New()'s in CBufFlat and CBufSeg to return a
+ pointer to the class rather than to CBufBase.
+12). Add a further global new operator which will leave if it cannot
+ allocate the memory. This is called as follows:
+ Normally:
+ TRect *p=new TRect(0,0,10,10);
+ With leave:
+ TRect *p=new(ELeave) TRect(0,0,10,10);
+13). Renamed TEnter::Throw() to TEnter::Leave();
+14). Fixed User::Leave().
+15). Add the full queue implemetations.
+16). Threads other than the main thread did not have their heap set.
+17). Lots more that I have forgotten.
+
+The TLex test code does not pass since it was relying on the zero
+terminator and I don't have the time to fix it. There is bug shown
+in CBufSeg with the test program T_ARRAY, although not surprisingly
+by T_BSEG.
+All the test code should now be reviewed and checked.
+
+Version 0.01.012
+================
+(Made by MartinB, 6 Jan 1995)
+1) Fixed death in release 11 below.
+2) Descriptor classes essentially complete. Moved iMaxLength from
+ TDesC to TDes. However must still define unicode-independent
+ buffers.
+3) Passes all test code now (except T_SEM).
+
+
+Version 0.01.011
+================
+(Made by MartinB, 6 Jan 1995)
+1) Bug fixes to Heap from MartinH.
+2) Bug fixes to arrays from Jal.
+3) Changed some pointer parameters to references.
+4) Changed to new Descriptor class hierarchy. The change is not yet
+ complete.
+5) Some things are now (partially) broken:
+ T_BUF does not pass all test code (wierd stack death),
+ T_ARRAY.CPP and T_BFLAT.CPP do not build,
+ T_LEX does not pass all test code.
+
+Version 0.01.010
+================
+(Made by MartinB, 4 Jan 1995)
+1) Minor bug fix to o_array.cpp.
+2) Fixes to slocl to support dynamic loading.
+3) Fixes to TLex and TChar code.
+4) Converted to using spaces for tabs.
+5) Incorporated DWs time class.
+6) Moved Steve's CRegion class to SOLIB.
+
+Version 0.01.009
+================
+(Made by MartinB, 22 Dec 1994)
+1) Minor bug fixes and improvements to descriptor code.
+2) Now partially buildable under EPR (courtesy of DuncanS). To get
+ extended toolset type:
+
+ TOOLS ETSET
+ TOOLS WINS
+
+You will also need to set your DOS box to run off a PIF file
+(ETSET.PIF in this directory will do), otherwise you will get out of
+memory/environment space problems.
+
+Then
+ ETON WINS
+and (in the usual way)
+ CONT E32 GROUP
+ DON
+ BUILD DEB
+
+Then you should be able to do MNT BLDALL. Unfortunately we don't yet
+have the technology to build DLLs yet, but we can do CCs and LFs.
+This certainly makes it much less tedious to build the test code.
+In CONT E32 TUSER type
+ EBLD ETLI
+In CONT E32 TOLIB type
+ EBLD LI
+
+Version 0.01.008
+================
+(Made by MartinB, 21 Dec 1994)
+1) Took Jal's fixes for CBufSeg class.
+2) Added
+ void Append(const TUint8* aBuf,TUint aLength);
+ function to TDesBase class.
+3) Removed the Assign() functions that were just duplicates of Copy()
+ from TDesBase.
+4) Split data in slocl into country dependent, language dependent and
+ alphabet (character set) dependent parts. Split not yet complete.
+
+Version 0.01.007
+================
+(Made by MartinB, 20 Dec 1994)
+1) Produces e32winsu.* and e32statu.* on UDEB and UREL builds.
+2) Moved to warning level 4.
+3) operator= changed to return reference in TPoint, TSize and TRect classes
+4) Converted CBuf* classes to constant reference convention.
+5) Changed TLex to use descriptors.
+
+Version 0.01.006
+================
+(Made by MartinB, 20 Dec 1994)
+1) #defined _UNICODE on UDEB and UREL in e32ver.h in preparation
+ for epr building.
+2) Converted TLex* class to constant reference convention.
+3) Renamed TSuffix to TDateSuffix.
+
+Version 0.01.005
+================
+(Made by MartinB, 19 Dec 1994)
+1) First version with buffers replaced by descriptors. Note that
+ ..\inc\e32db16.h
+ is a copy of
+ ..\inc\e32db8.h
+ with 8 replaced by 16 throughout, and
+ ..\suser\u_dsbf16.cpp
+ is a copy of
+ ..\suser\u_dsbf8.cpp
+ with 8 replaced by 16 throughout.
+
+ This is necessary since it seems impossible to use templates in
+ this case (this is because there seems to be no way to manually
+ instantiate the template so that it can be placed in the DLL).
+2) Passes all test code except T_BFLAT (which I didn't get to work on
+ version 004) and T_SEM (which I'm not sure about).
+3) TThread class broken? It may well work but I have not yet looked
+ into the implications for this class.
+4) Made this version for a "safe" one to come back to.
+5) U_LEX*.CPP and U_SEG.CPP can now be much improved by using
+ Descriptors instead of temporary buffers.
+
+Version 0.01.004
+================
+(Made by MartinB, 19 Dec 1994)
+1) Minor fixes to SLOCL tables.
+2) Defined ASSERTn and ASSERT_VALIDn macros.
+3) Last version before new TDes and TBuf classes.
+
+Version 0.01.003
+================
+(Made by MartinB, 14 Dec 1994)
+1) Incorporates TPoint, TSize, TRect & TRegion classes.
+2) Incorporates test code for above.
+3) Moved TCheckedHeapWalk declaration into THeap (ie nested class
+ declaration), partially because of name class with TSize (above).
+
+Version 0.01.002
+================
+(Made by MartinB, 13 Dec 1994)
+1) Incorporates buf fixes to TChar, TLex & TBuf classes.
+2) Incorporates test code for above.
+3) First working UNICODE version.
+
+Version 0.01.001
+================
+(Made by Colly, 10 Dec 1994)
+1) First release.