Missing part of the workaround for Bug 2149 - need to remove bootstrap.xml as well to disable SBS use of bootstrap.flm
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.