ExternalVendorCode/genode
1
0
Fork 0
mirror of https://github.com/genodelabs/genode.git synced 2024-12-22 06:57:51 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
2e92b7ae32
genode/repos/base/include/spec/x86/bios_data_area.h

60 lines
1.3 KiB
C
Raw Normal View History

base: use BDA header in base-nova like base-hw Moves the Bios Data Area header from base-hw to base. Modifies the base-nova core console that it uses the header as replacement for the previous BDA bit logic. Ref #1625
2015-07-10 17:58:30 +00:00
/*
* \brief Structure of the Bios Data Area after preparation through Bender
* \author Martin Stein
* \date 2015-07-10
*/
/*
Adjust file headers to refer to the AGPLv3
2017-02-20 12:23:52 +00:00
* Copyright (C) 2015-2017 Genode Labs GmbH
base: use BDA header in base-nova like base-hw Moves the Bios Data Area header from base-hw to base. Modifies the base-nova core console that it uses the header as replacement for the previous BDA bit logic. Ref #1625
2015-07-10 17:58:30 +00:00
*
* This file is part of the Genode OS framework, which is distributed
Adjust file headers to refer to the AGPLv3
2017-02-20 12:23:52 +00:00
* under the terms of the GNU Affero General Public License version 3.
base: use BDA header in base-nova like base-hw Moves the Bios Data Area header from base-hw to base. Modifies the base-nova core console that it uses the header as replacement for the previous BDA bit logic. Ref #1625
2015-07-10 17:58:30 +00:00
*/
Introduce 'spec' subdirectories to outline aspects Instead of holding SPEC-variable dependent files and directories inline within the repository structure, move them into 'spec' subdirectories at the corresponding levels, e.g.: repos/base/include/spec repos/base/mk/spec repos/base/lib/mk/spec repos/base/src/core/spec ... Moreover, this commit removes the 'platform' directories. That term was used in an overloaded sense. All SPEC-relative 'platform' directories are now named 'spec'. Other files, like for instance those related to the kernel/architecture specific startup library, where moved from 'platform' directories to explicit, more meaningful places like e.g.: 'src/lib/startup'. Fix #1673
2015-09-03 12:55:05 +00:00
#ifndef _INCLUDE__SPEC__X86__BIOS_DATA_AREA_H_
#define _INCLUDE__SPEC__X86__BIOS_DATA_AREA_H_
base: use BDA header in base-nova like base-hw Moves the Bios Data Area header from base-hw to base. Modifies the base-nova core console that it uses the header as replacement for the previous BDA bit logic. Ref #1625
2015-07-10 17:58:30 +00:00
/* Genode includes */
#include <util/mmio.h>
base: uniform base-internal header structure This patch establishes a common organization of header files internal to the base framework. The internal headers are located at '<repository>/src/include/base/internal/'. This structure has been choosen to make the nature of those headers immediately clear when included: #include <base/internal/lock_helper.h> Issue #1832
2016-01-20 17:27:18 +00:00
/* base-internal includes */
#include <base/internal/unmanaged_singleton.h>
base: use BDA header in base-nova like base-hw Moves the Bios Data Area header from base-hw to base. Modifies the base-nova core console that it uses the header as replacement for the previous BDA bit logic. Ref #1625
2015-07-10 17:58:30 +00:00
namespace Genode { class Bios_data_area; }
mmio: upper-bounds checks The classes Genode::Mmio, Genode::Register_set, Genode::Attached_mmio, and Platform::Device::Mmio now receive a template parameter 'size_t SIZE'. In each type that derives from one of these classes, it is now statically checked that the range of each Genode::Register::Register- and Genode::Register_set::Register_array-deriving sub-type is within [0..SIZE). That said, SIZE is the minimum size of the memory region provided to the above mentioned Mmio classes in order to avoid page faults or memory corruption when accessing the registers and register arrays declared inside. Note, that the range end of a register array is not the end of the last item but the end of integer access that is used for accessing the last bit in the last item. The constructors of Genode::Mmio, Genode::Attached_mmio, and Platform::Device::Mmio now receive an argument 'Byte_range_ptr range' that is expected to be the range of the backing memory region. In each type that derives from on of these classes, it is now dynamically checked that 'range.num_bytes >= SIZE', thereby implementing the above mention protection against page faults and memory corruption. The rest of the commit adapts the code throughout the Genode Labs repositories regarding the changes. Note that for that code inside Core, the commits mostly uses a simplified approach by constructing MMIO objects with range [base..base+SIZE) and not with a mapping- or specification-related range size. This should be fixed in the future. Furthermore, there are types that derive from an MMIO class but don't declare any registers or register arrays (especially with Platform::Device::Mmio). In this case SIZE is set to 0. This way, the parameters must be actively corrected by someone who later wants to add registers or register arrays, plus the places can be easily found by grep'ing for Mmio<0>. Fix #4081
2024-01-10 14:08:53 +00:00
class Genode::Bios_data_area : Mmio<0x12>
base: use BDA header in base-nova like base-hw Moves the Bios Data Area header from base-hw to base. Modifies the base-nova core console that it uses the header as replacement for the previous BDA bit logic. Ref #1625
2015-07-10 17:58:30 +00:00
{
friend Unmanaged_singleton_constructor;
private:
mmio: upper-bounds checks The classes Genode::Mmio, Genode::Register_set, Genode::Attached_mmio, and Platform::Device::Mmio now receive a template parameter 'size_t SIZE'. In each type that derives from one of these classes, it is now statically checked that the range of each Genode::Register::Register- and Genode::Register_set::Register_array-deriving sub-type is within [0..SIZE). That said, SIZE is the minimum size of the memory region provided to the above mentioned Mmio classes in order to avoid page faults or memory corruption when accessing the registers and register arrays declared inside. Note, that the range end of a register array is not the end of the last item but the end of integer access that is used for accessing the last bit in the last item. The constructors of Genode::Mmio, Genode::Attached_mmio, and Platform::Device::Mmio now receive an argument 'Byte_range_ptr range' that is expected to be the range of the backing memory region. In each type that derives from on of these classes, it is now dynamically checked that 'range.num_bytes >= SIZE', thereby implementing the above mention protection against page faults and memory corruption. The rest of the commit adapts the code throughout the Genode Labs repositories regarding the changes. Note that for that code inside Core, the commits mostly uses a simplified approach by constructing MMIO objects with range [base..base+SIZE) and not with a mapping- or specification-related range size. This should be fixed in the future. Furthermore, there are types that derive from an MMIO class but don't declare any registers or register arrays (especially with Platform::Device::Mmio). In this case SIZE is set to 0. This way, the parameters must be actively corrected by someone who later wants to add registers or register arrays, plus the places can be easily found by grep'ing for Mmio<0>. Fix #4081
2024-01-10 14:08:53 +00:00
struct Serial_base_com1 : Register<0x0, 16> { };
struct Equipment : Register<0x10, 16>
base: use BDA header in base-nova like base-hw Moves the Bios Data Area header from base-hw to base. Modifies the base-nova core console that it uses the header as replacement for the previous BDA bit logic. Ref #1625
2015-07-10 17:58:30 +00:00
{
struct Serial_count : Bitfield<9, 3> { };
};
static addr_t _mmio_base_virt();
mmio: upper-bounds checks The classes Genode::Mmio, Genode::Register_set, Genode::Attached_mmio, and Platform::Device::Mmio now receive a template parameter 'size_t SIZE'. In each type that derives from one of these classes, it is now statically checked that the range of each Genode::Register::Register- and Genode::Register_set::Register_array-deriving sub-type is within [0..SIZE). That said, SIZE is the minimum size of the memory region provided to the above mentioned Mmio classes in order to avoid page faults or memory corruption when accessing the registers and register arrays declared inside. Note, that the range end of a register array is not the end of the last item but the end of integer access that is used for accessing the last bit in the last item. The constructors of Genode::Mmio, Genode::Attached_mmio, and Platform::Device::Mmio now receive an argument 'Byte_range_ptr range' that is expected to be the range of the backing memory region. In each type that derives from on of these classes, it is now dynamically checked that 'range.num_bytes >= SIZE', thereby implementing the above mention protection against page faults and memory corruption. The rest of the commit adapts the code throughout the Genode Labs repositories regarding the changes. Note that for that code inside Core, the commits mostly uses a simplified approach by constructing MMIO objects with range [base..base+SIZE) and not with a mapping- or specification-related range size. This should be fixed in the future. Furthermore, there are types that derive from an MMIO class but don't declare any registers or register arrays (especially with Platform::Device::Mmio). In this case SIZE is set to 0. This way, the parameters must be actively corrected by someone who later wants to add registers or register arrays, plus the places can be easily found by grep'ing for Mmio<0>. Fix #4081
2024-01-10 14:08:53 +00:00
Bios_data_area() : Mmio({(char *)(_mmio_base_virt() + 0x400), Mmio::SIZE}) { }
base: use BDA header in base-nova like base-hw Moves the Bios Data Area header from base-hw to base. Modifies the base-nova core console that it uses the header as replacement for the previous BDA bit logic. Ref #1625
2015-07-10 17:58:30 +00:00
public:
/**
* Obtain I/O ports of COM interfaces from BDA
*/
base: avoid implicit conversions This patch is a prerequisite for compiling the code with the warnings -Wconversion enabled. Issue #23
2021-12-02 10:21:14 +00:00
uint16_t serial_port() const
base: use BDA header in base-nova like base-hw Moves the Bios Data Area header from base-hw to base. Modifies the base-nova core console that it uses the header as replacement for the previous BDA bit logic. Ref #1625
2015-07-10 17:58:30 +00:00
{
Equipment::access_t count = read<Equipment::Serial_count>();
return count ? read<Serial_base_com1>() : 0;
}
/**
* Return BDA singleton
*/
static Bios_data_area * singleton() {
return unmanaged_singleton<Bios_data_area>(); }
};
Introduce 'spec' subdirectories to outline aspects Instead of holding SPEC-variable dependent files and directories inline within the repository structure, move them into 'spec' subdirectories at the corresponding levels, e.g.: repos/base/include/spec repos/base/mk/spec repos/base/lib/mk/spec repos/base/src/core/spec ... Moreover, this commit removes the 'platform' directories. That term was used in an overloaded sense. All SPEC-relative 'platform' directories are now named 'spec'. Other files, like for instance those related to the kernel/architecture specific startup library, where moved from 'platform' directories to explicit, more meaningful places like e.g.: 'src/lib/startup'. Fix #1673
2015-09-03 12:55:05 +00:00
#endif /* _INCLUDE__SPEC__X86__BIOS_DATA_AREA_H_ */
Reference in New Issue Copy Permalink