[[PageOutline]] = Welcome to the ACPI Project on Netlabs = This is the development and support home for ACPI Project. The software in this project is not ACPI. The ACPI is supplied by your computer's vendor in the BIOS. The software in this project is a Platform Specific Driver (PSD) and related files and programs that use the ACPI in your computer's BIOS to configure and operate your computer. 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 Architecture which is the interface to your computer's ACPI. 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 Advanced Power Management interface that emulates APM functions using ACPI. This driver is not required for proper operation of ACPI.PSD, but may be required for some older programs that use APM functions. APM.ADD normally goes in \OS2\BOOT. * !AcpiDaemon.EXE - A program that implements certain system functions like CPU throttling, power button handling, various events like 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 [#ApplicationDriverDevelopers 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. = Submitting Tickets = Before submitting a ticket, make sure you have read the [wiki:Requirements Requirements, Limitations, and Problems] page. Reporting bugs and requesting new features is done through the ticket system. You can view existing tickets, add comments to them and create new tickets using the corresponding buttons at the top of every page. If you want to submit a new bug or request a feature, please use the Search function first to make sure there is no ticket for the same problem already created. * Please enter a useful description of the actual problem in the Summary. * If you think your hardware information is useful, put that information in the Description, not in the Summary. * Do not put the ACPI version number in the Summary. * Please only submit one issue on a ticket. Do not list several issues on a single ticket. Be clear and specific and include all information necessary to show that the problem is being caused by the ACPI software. DO NOT just submit a "report" of your experience. The system that automatically sends you an e-mail when your ticket is updated is currently broken. To work around this, simply make sure you put your e-mail address in the Cc: field when (or after) you create a ticket. This will ensure that you get an e-mail whenever your ticket is updated. We review the tickets regularly and leave comments if we need more info. So please revisit the [http://svn.netlabs.org/acpi/report/13 Feedback analysis] as often as possible. If we leave a comment and don't get feedback from the ticket creator, we will close the ticket after some weeks. 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 !community@netlabs.org [mailto:community@netlabs.org 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. == 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.21.02). If you are reporting for some other version, please override the default. If you are not using the latest version, you should try it to see if it fixes your problem. 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 [http://88watts.net/download/AcpiReadMe.txt 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 some old, mostly obsolete, 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 [http://www.ecomstation.com eComStation] login, but the ACPI download may not appear New releases are announced on the mailing list and elsewhere. Recent releases ||Version||Date||Warpin File||MD5 Checksum of Warpin File|| ||3.20.04||2012-Jul-23||acpi-3.20.04.exe||827C6678C91967AC63D211EADAD41280|| ||3.21.01||2012-Aug-26||acpi-3.21.01.exe||11C3B371162A6F7FE3E9D4ED868E6B28|| ||3.21.02||2012-Sep-06||acpi-3.21.02.exe||6D77678FFB460EFFEC3C75ED5615B622|| == 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.21.zip acpi-toolkit-3.21.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 }}} {{{#!comment 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.