[[PageOutline]] = Welcome to the ACPI Project on Netlabs = This is the development and support home for ACPI Project. The ACPI Project is an ACPI based Platform Specific Driver (PSD) and related files and programs. This project produces 5 files and a toolkit for program development: * ACPI.PSD - the Platform Specific Driver that sets up and controls the hardware, and also implements the ACPI Component Archetecture. This is the main component of the ACPI project. ACPI.PSD normally goes in \OS2\BOOT. * ACPI32.DLL - The interface between ACPI.PSD and other programs (like !AcpiDaemon.exe) so that they can use the ACPI functions in the PSD. This DLL is not required for proper operation of ACPI.PSD, but most programs will not be able to use any ACPI services if you do not install it. ACPI32.DLL normally goes in \OS2\DLL. * APM.ADD - An implementation of the legacy Advanced Power Management interface for use with ACPI.PSD. This driver is not required for proper operation of ACPI.PSD. APM.ADD normally goes in \OS2\BOOT. * !AcpiDaemon.EXE - A program that implements certain system functions like CPU throttling, power button handling, lid open/close events, suspend/resume, etc. This program is not required for proper operation of ACPI.PSD, but is required for proper operation of APM.ADD. !AcpiDaemon.EXE requires ACPI32.DLL and normally goes in \OS2. * ACPID.CFG - The configuration file for !AcpiDaemon.exe. ACPID.CFG must go in the directory specified by the ETC environment variable. * The toolkit - For developing programs that interface with ACPI.PSD In order to use this software you must have a system with valid ACPI tables. This software is not supported on systems without valid ACPI tables. The PSD in this software package is not a "universal" PSD. It is an ACPI based PSD. This means that valid ACPI tables are required for this software to operate correctly and this software does not attempt to fix every quirk in every system unless those quirks are addressed in the ACPI tables. All modern computers have ACPI tables. This software will fail to load if your system does not have ACPI tables. In addition, some functions may fail to work properly if your ACPI tables are defective. It was common for older computers to have broken ACPI tables, but the situation is getting better. If you have a problem with bad ACPI tables, your computer vendor may have updated ACPI tables that you can install. A new version of the ACPI PSD is in development. Information and updates will be posted here. == Testing and Submitting Tickets == Please read the [TestingGuide Testing Guidelines] page for information on how to test and how to collect information for reporting problems. You must be logged into TRAC to create tickets. Please login with your Netlabs login id. If you do not have a login id, you can request one at http://www.netlabs.org/en/site/member/member.xml. If you have troubles acquiring a Netlabs login id send an e-mail to {{{ #!html Netlabs Community Mailing List }}} If you have open tickets created with the guest login, please add a comment to the ticket showing your new login and we will update the ticket so that you automatically receive e-mail when your open tickets are updated. Before entering a ticket, please read the [TestingGuide Testing Guidelines] page for information on how to test and how to collect information for reporting problems. === Milestones and Versions === When entering tickets, you will be asked to provide a version and a milestone. The [http://trac.edgewall.org/wiki/TracTickets TRAC documentation] defines these terms as * Version - Version of the project that this ticket pertains to. * Milestone - When this issue should be resolved at the latest. For new tickets, the version will default to current ACPI version (i.e. 3.19.10). If you are reporting for some other version, please override the default. The milestone will default to the next scheduled ACPI version release (i.e. 4.0.0). Generally, once a ticket is opened, the version should not be changed. If the issue is not resolved, the milestone will be changed to reflect when the ticket is expected to be resolved. = Users = Please read the readme and the PSD_EN.INF documentation that is included in the distribution before installing and using this software. The [http://en.ecomstation.ru/projects/acpitools/ ACPI Tools] page contains a wealth of information and links. {{{#!comment See [UserGuide Getting the most from ACPI] for hints from the power users. The [http://ru.ecomstation.ru/projects/acpitools/?action=faq ACPI FAQ] contains answers to your questions. Currently, [http://en.ecomstation.ru/projects/acpitools/?action=hardware ACPI Switches by System] is probably the best place to go to check if your motherboard or system is already supported by the ACPI driver. Eventually, this information will be integrated into the[http://en.ecomstation.ru/hardware.php?action=category§ion=mb Compatible Systems] database. The information will also be available sorted by [http://en.ecomstation.ru/hardware.php?action=category§ion=brand brand]. }}} == Binaries == New releases are available from the eComStation !BetaZone. Log in to [http://shop.mensys.com Mensys] with your Mensys login id and click the Downloads link. Click the "Software Subscription Services for eComStation" Download link and the ACPI drivers should be listed. You can access the !BetaZone from your [www.ecomstation.com eComStation] login, but the ACPI download may not appear New releases are announced on the mailing list and elsewhere. == Mailing List == As you might have suspected, ACPI is a Netlabs project. The project URL is [wiki:/ ACPI] The support mailing list is at [mailto:acpi-dev@netlabs.org ACPI Mailing List] If you can't see the mailto link, you are not logged in. To subscribe to the mailing list, send a message to [mailto:acpi-dev-subscribe@netlabs.org Subscribe to ACPI Mailing List]. The subject and body can be empty. You will receive a response which you must reply to to complete the process. These lists are [http://www.ezmlm.org EzMLM] mailing lists. If you need help subscribing, see [http://wiki.netlabs.org/index.php/Mailinglists Netlabs Mailing Lists]. = Application / Driver Developers = A toolkit is available for using ACPI services. Applications can link to acpi32.lib and drivers can link to acpidrv.lib. These libraries and header files are included in the toolkit. Sample programs and documentation are provided as well. You can download the current toolkit here: [http://www.88watts.net/download/acpi-toolkit-3.19.zip acpi-toolkit-3.19.zip] = ACPI Developers = == Getting the sources == In addition to [../browser browsing] the sources here, you can check out the [/repos/acpi sources] with your favorite subversion client. Keep in mind that, unlike [http://www.nongnu.org/cvs/ cvs], tags and branches are ordinary directories in subversion. With the typical subversion repository layout, it is rather easy to checkout more than you probably intend to. To pull just the trunk version, use something like {{{ mkdir acpi_workspace cd acpi_workspace svn checkout http://svn.netlabs.org/repos/acpi/trunk trunk }}} To update your workspace with the current repository content, use {{{ cd acpi_workspace\trunk svn update }}} Driver developers that wish to make their drivers ACPI compliant will find the [http://ecomstation.ru/projects/developer/?action=acpi ACPI toolkit] useful. == Building == Those interested in building the ACPI drivers or submitting source code updates should see [wiki:Building Building the ACPI Drivers][[BR]] [CodingGuide ACPI Developers Coding Guide][[BR]] [wiki:DevelopersFAQ ACPI Developers FAQ - coming soon][[BR]] = Credits = * Pavel (pasha) Shtemenko * David Azarewicz * Steven Levine * Lars Erdmann If we forgot anyone, please let us know. It was unintentional.